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Chapter 1 
INTRODUCTION 



1.1 PRODUCT DESCRIPTION 

The TDS (Tiny Development System) is a stand-alone board-level software support system for 
the Series 32000 family of advanced microprocessors. The TDS software provides the means 
for the user to generate Series 32000 executable code. 

TDS utilities enable the user to originate, edit, assemble, debug, and execute Series 32000 
small source programs. These also support the use of an optional cassette tape recorder for the 
storage and retrieval of source programs, and the use of a parallel printer for the generation of 
program listings. TDS is intended as a demonstration tool for Series 32000 development 
boards. TDS utilities cannot substitute for a full development system and are not designed to 
be integrated into a customer product. 

In addition to a text editor, an assembler, and a symbolic debugger, TDS includes run-time 
support routmes that manage terminal 1/0 access to peripheral devices, and complete 
numerical conversions requestable by user programs. 

On the DB160(X) board TDS PROMs plug into sockets U9, UIO, Ull and U12. On the 
DB32016 board TDS plugs into U13 and U15. On the DB32000 board TDS plugs into U163, 
U145, U125, andUlll. 



1.2 FUNCTIONAL OVERVIEW 



1.2.1 Interactive TDS Software Environment 

The TDS software system resides in PROMS on currently available Series 32000 development 
boards. The appendices contain information specific to the particular development board used. 
TDS facilities are available to the user once the development board is running in a stand-alone 
mode. Refer to the individual development board mantial for information necessary to 
establish the required stand-alone environment. 

The available TDS utilities are: 

• A Text Editor 

• An Assembler 

• A Symbolic Debugger 
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Text Editor 

Enables the user to create and maintain source programs. Text editor commands support the 
creation, deletion, insertion, replacement, and display of user-originated programs. Source lines 
created or edited are automatically sequenced for easy use and reference. 



Assembler 

Assembles user progr^lms and produces machine executable code. Assembler error messages 
alert the user to errors detected during the assembly of a source program. 



Symbolic Debugger 

Provides program debug aids that allow the user to step through an assembled program, follow 
the program flow at source level by setting up breakpoints symbolically if the source line is 
labeled, symbolically print or change the contents of memory and system registers, search 
system memory for specific data, move blocks of data from one location in system memory to 
another, and fill contiguous locations of system memory with data. 



1.2.2 Peripheral Environment and Run-Time Support 

TDS also provides the following for the usen 

• Peripheral Interfacing 

• Run-Time Support 

TDS supports two RS232-C ports and one parallel port One of the RS232-C ports is designated 
as port and the other port is designated as port 1. Port is the main system port where the 
user terminal is connected, and port 1 is the system auxiliary port. Port 1 can accommodate 
any serial peripheral device. The parallel port is used to implement the audio cassette interface 
for source program/data storage and retrieval. It can also support any Centronics-type parallel 
printer to generate source listings or record data outputs. 

Run-time support services provide the user with the ability to access ports and 1, and the 
parallel printer port. Run-time support services also permit the user to perform ASQI to 
binary and binary to ASCII numerical conversions on four user-selected bases. 



i .J Kt^i^A I tLU jLAlCuiVAr.iS 1 A 1 lUiS 

If TDS is to be used to develop source programs for Series 32000 microprocessors, the user 
must understand the architecture of the Series 32000 family of microprocessors and their 
programming requirements. See the Series 32000 Instruction Set Reference Manual, 
Customer Order Number NSP-INST-REF-M, for additional information. 
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1.4 MANUAL ORGANIZATION 

This manual is divided into nine chapters and appendices A through C. Each appendix 
contains nine sections. Appendix A references DB16000; Appendix B references DB32016; and 
Appendix C references DB32000. The manual is organized in the following order: 

• Chapter 2 — General System Conventions 

• Chapter 3 - System Initialization 

• Chapter 4 - Text Editor 

• Chapter 5 — Assembler 

• Chapter 6 - Symbolic Debugger 

• Chapter 7 - Run-Time Support 

• Chapter 8 - Program Execution and Sample Development Session 

• Chapter 9 - Peripheral Interfacing 

• Appendix A - TDS on the DB16(X)0 

• Appendix B - TDS on the DB32016 

• Appendix C - TDS on the DB32000 

Each appendix is divided into nine sections as listed below: 

• Sections A.1, B.1, C.1 — Auxiliary Port Setup Procedures 

• Sections A.2, B.2, C.2 - Baud Rate Setups 

• Sections A.3, B.3, C.3 — Numerical Data 

• Sections A.4, B.4, C.4 — Parallel Printer Interface Data 

• Sections A.5, B.5, C.5 - Cassette Interface Data 

• Sections A.6, R6, C.6 — Assembler User Notes 

• Sections A.7, B.7, C.7 - TDS Memory Map 

• Sections A.8, B.8, C.8 - TDS Error Summary 

• Sections A.9, B.9, C.9 - TDS Command Summary 

Chapter 2 introduces the user TDS procedural fundamentals and defines its documentation 
conventions. 

Chapter 3 provides information on initializing TDS, selecting communication m.ode for the 
user terminal, and selecting the system default base for the data output. 

Chapter 4 lists and defines the commands, error messages, and procedures made available by 
the text editor. 

Chapter 5 lists and defines the commands and the assembly syntax accepted by the assembler, 
and the error messages output by the assembler. 
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Chapter 6 lists and defines the symboHc debugger printer commands, change commands, 
special processing commands, and execution commands. The chapter also lists and defines error 
messages output by the debugger, and the method of program initialization. 

Chapter 7 explains RTS use and lists the conventions of the routines used to support 
peripheral access and numerical conversions. 

Chapter 8 presents a sample development session where source code is entered for sample 
programs and assembled. Debugging tools are demonstrated and the program is executed. The 
chapter also provides information concerning slave support. 

Chapter 9 provides information on the requirements and use of the peripheral devices 
supported by TDS. 

A complete set of appendices for the various development boards provides information on 
hardware set-ups, ranges and syntax of numerical values, parallel printer interface cable pin- 
outs, and cassette tape interface cable construction details and interface timing data. The 
appendices also provide memory maps of the TDS system, a complete summary of all TDS 
error messages, and a summary of all commands (listed in functional sequence) supported by 
TDS. 
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Chapter 2 
GENERAL SYSTEM CONTENTIONS 



2.1 INTRODUCTION 

The user interface to TDS is the command line interpretive (CL!) mode. The CLI mode is the 
user's link to the facilities provided by TDS. 

The CLI mode is the main mode of control for TDS and is characterized by an asterisk (*) at 
the left edge of the users terminal screen, marking the beginning of a line. The asterisk 
indicates that a user may enter a command. The CLI mode listens to user commands and 
responds with desired results or an error message. Errors in commands or syntax will cause 
TDS to respond with a question mark (?). Whenever the "T is displayed by TDS, the 
command line originally entered is ignored. After the question mark is displayed, TDS issues a 
line feed if the communication option is set (see Section 3.3.2, DM Command) TDS also 
displays the "*" once again. Consult Chapter 3 for the proper setting of the communications 
mode for the terminal. 

Commands consist of one or two letters (upper or lower case) and eire entered immediately 
after the "*". Command parameters are separated by a single space. Commands are executed 
when a <CR> carriage return is entered. Any exceptions to this convention are covered 
during individual command descriptions. 

Tabs, line feeds, or special characters are ignored. 

The backspace or delete key may be used to delete characters. A deleted character is replaced 
by a space and the cursor is positioned over the deleted character. Backspacing or deleting to 
the beginning of the line will null that line and TDS will display the "*" prompt. 

TDS uses the control "Q" and "S" keys to control scrolling functions. The <crtl/S> is used to 
stop terminal output, and the <crtl/Q> continues the terminal output. The scrolling 
functions are supported only at the main port (port 0). 

The maximum character length of a valid command line is 62. If this maximum is exceeded, 
TDS outputs the "?" and the command line input is ignored. 



2.2 DOCUMENTATION CONVENTIONS 

The following documentation conventions are used in describing commands and parameters. 
Except for mnemonics any combination of upper- and loVv''er-<:ase letters may actually be used 
when entering commands. 

Upper-case letters show the instruction and directive mnemonics. The mnemonics 
must be entered exactly as shown. 

Italics are used for items supplied by the user. The italicized word is a generic 
term for the actual operand that the user enters. 
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spaces or blanks, when present, are significant; they must be entered as shown. 
Multiple blanks or horizontal tabs may be used in place of a single blank. 

{ } Large braces enclose two or more items of which one, and only one, must be 
used. The items are separated from each other by a logical OR sign " | ". 

[ ] Large brackets enclose optional item(s). 

I Logical OR sign separates items of which one, and only one, may be used. 

Three consecutive periods indicate optional repetition of the preceding 
item(s). If a group of items can be repeated, the group is enclosed in large 
parentheses "( )". 

,„ Three consecutive commas indicate optional repetition of the preceding 

item. Items must be separated by commas. If a group of items can be 
repeated, the group is enclosed in large parentheses "( )". 

( ) Large parentheses enclose items which need to be grouped together for 
optional repetition. If three consecutive commas or periods follow an item, 
only that item may be repeated. The parentheses indicate that the group 
may be repeated. 

Li Indicates a space, u is only used to indicate a speci&c number of required 

spaces. 

User inputs of nonprinting keys are indicated by enclosing a name for the key in 
angle brackets <> ( <CR> indicates the RETURN key). 

All other characters or symbols appearing in the syntax must be entered as shown. 
Brackets, parentheses, or braces which must be entered, are smaller than the 
symbols used to describe the syntax. (Compare user-entered [1 with [] which 
show optional items.) 

In interactive examples where both user input and system responses are shown, the 
machine output is in regular type. User-entered input is in boldface type. 



Parameters: 

Number (n) digits 

Where digits equal one or more decimal digits (0 through 9). 

General-Number { D' j H' i d' i h' ; ["J oig'^i^ 

ign) Where digits are compatible with selected base. Hex value digits 

are through 9 and A through F (upper or lower case). (-) 
specifies negative value. Default base numbers require only digits 
for input gn is zero-extended or truncated to byte, word, or 
double-word according to any size restriction common to a 
particular operation. See Appendices A.3, B.3, and C.3 for 
additional numerical information. 
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Real-Number n [. [n]] [e\ E [+\-]n ] 

(rn) When used in symbolic debugger operations, the [E] must be upper 

case. See Appendices A.3, B.3, and C.3 for further information. 

General gn 

Address (addr) Where gn >=0 

CPU register {PC|SB|FP|US|IS|SP|IN|PS|M0D} 

icpitreg) 
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Chapter 3 
SYSTEM INITIALI5LATI0N 



3.1 INTRODUCTION 

The TDS user must enter the required initialization command and optionally set terminal 
communication mode and system base for numerical interpretations. Sections 3.2 through 3.3.2 
detail this information. 



3.2 INITIALIZATION PROCEDURE 

Once the development board is powered up and reset in stand-alone mode, TDS displays the 
following message: 

*TDS Rev N.NN DAY-MON-YR (BOARD VERSION) 

The "*" should appear on the left-most side of the terminal screen. The asterisk indicates that 
TDS is in the CLI mode and is prepared to accept a command line input 

Enter IT (for initialize) at the terminal and press <CR>. 

The IT command initializes functions not performed by a hardware reset. If the IT command 
is not entered before the user attempts to use TDS facilities, TDS will not function properly. 



3.3 TERMINAL COMMUNICATIONS AND SYSTEM USE COMMANDS 

Two commands are supported by TDS that enable the user to set up specific conditions within 
the TDS system. One command sets the default base for symbolic debugger functions, and the 
other command sets user communication modes at the main user port (port 0). Those two 
commands respectively are: RX and OM. The following paragraphs present the syntax of each 
command and discuss their use. If the user does not use the RX and OM commands to make 
the applicable selections, TDS will use default values. 



3.3.1 RX Command 

The select radix (RX) command sets the default base (hex or decimal) for the symbolic 
debugger command parameters and causes all command responses to be output in the selected 
base. The syntax of the command is: 

RX {H|d} 

If a command argument is different from the selected base, it must be preceded by If, h', D', 
or d'. 

For example, if a user wishes to use the debugger facilities to display the contents of system 
memory at decimal location 100, and the selected base is hex, the command line input must 
specify D'lOO as the address. The output is in hex notation. If the user wants to examine hex 
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location 100, it is not necessjiry to use the HTIOO notation in the command line since the 
selected base is already hex. The IT command initially sets the radix to hex. 

The commands and facilities of the symbolic debugger are described in Chapter 6. 



3.3.2 OM Command 

The operation mode (OM) command sets the communications mode of the user terminal 
connected to the main port (port 0) of the development board. 

The syntax of the command is: 

OM gn 

Valid values for gn in this case are: through 4. OM is initially set to by the hardware 
reset. 

TDS uses full duplex communications with the user terminal. All inputs to TDS are echoed 
back to the user terminal. The OM command controls how carriage returns are treated during 
echo and how carriage returns are handled during output responses to commands. The values 
for gn have the following meaning: 



Gn 


ACTION 





Echo <CR>as <CR>+ <LF> 


1 


Echo <CR>as <CR> 


2 


Output <CR>as <CR>+ <LF> 


3 


Echo <CR>as <CR> and output <CR>only 


4 


Echo <CR> as space 
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Chapter 4 
TEXT EDITOR 

4.1 INTRODUCTION 

The system text editor is used to perform the following tasks: 

• Create source programs for Series 32000 microprocessors. 

• Change source text. 

• Display multiple lines of source text. 

• Insert new lines of source text. 

• Delete lines of source text. 

lists and defines the error messages output by the text editor. 

4.2 TEXT EDITOR COMMANDS 

TDS provides a line numbering sequence that can automatically number or renumber lines. 
Each command supporting the text editor tracks the line numbering sequence. Switching 
between commands requires that the user specify desired line numbers. 

The commands supporting the text editor functions are: INSERT, TYPE, REPLACE, KILL, and 
RESET. Sections 4.2.1 through 4.2.5 define the syntax of each command and their respective 
uses. 

4.2.1 Insert Command 

The Insert command is used to create source text if the editor text buffer is empty, or to insert 
one or more new text lines in text already contained in the editor buffer, or to append one or 
more new text lines to text contained in the editor buffer. 

The syntax of the Insert command is: 

IN [n. ] string 

Where n is the line number and string is a valid string that conforms to one of the 
conventions outlined in Section 5.2. 

If the editor text buffer is empty, the automatic sequencing feature of the editor allows the 
user to begin creating source text by entering: 

IN string <CR> 

The first line of text entered becomes line 0000 in the buffer. Entering the same command line 
again, with perhaps a different string, results in the second line becoming line 0001 of text in 
the buffer. The sequence continues until the user has entered the desired number of text lines. 
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To insert new text lines into existing text, the user chooses the existing text line above which 
the new text line is to be inserted. 



4.2.2 Type Command 

The Type command is used to list or display a specific line or multiple lines of text contained 
in the text buifer. 

The syntax of the command is: 

TP [nJ [/n2]] 
Where nl is the first line to be typed and n2 is the number of lines to be typed. 
To list text line 0003 from the text buifer, enter: 

TP3 <CR> 

When the Type command is used without specifying nl, the value of nl follows the value of 
n set by the Insert or Replace command. 

For example, if the Insert command is used to insert a new line of text, and the Type 
command is used immediately afterwards without specifying an nl or n2 value, the line 
previously inserted is displayedL If an n2 value is specified and an nl value is not, the desired 
number of lines are displayed beginning with the line previously inserted. 

The Type command displays a maximum of 127 lines. 

For example, a user wishing to insert a line at line 2, would enten 

IN 2 TEXT 
To type three lines of text beginning with the line just inserted, enten 

TP/3 

However, entering 

IN 2 TEXT 

TP 7/2 

IN NEWTEXT 

may produce incorrect results. If the user inserts a line at line 2 and then types out 2 lines 
beginning at line 7, the user cannot use simply the IN command to begin inserting text after 
the last line of text inserted. The TP command changed the default value of n to 7. Using the 
IN command without respecifying n would insert a line or lines beginning at line 7 of text 
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4.2.3 Replace Command 

The Replace command is used to replace a line of text in the buifer with a new line of text 
The syntax of the command is: 

RP n string 
When the RP command is used, n must be specified. 

4.2.4 Kill Command 

The Kill command is used to delete a line of text from the text buffer. 
The syntax of the Kill command is: 

KI Al 

When the KI command is used, n must be specified. 

4.2.5 Reset Command 

The Reset command clears the text editor buffer. 

The syntax of the command is: 

RS 

Whenever the Reset command is invoked, the text buffer is cleared and is immediately 
available for the input of new text. 

4.3 EDITOR ERROR MESSAGES 

The text editor can issue two error messages: 

BAD_TXT 

ERR_ED# 

The bad text (BAD_TXT) error message is output by the editor if an incorrect text sequence is 
entered. The error message may also occur if a runaway program altered text buffer or editor 
parameters. In such an event, the RESET command should be entered. 

The error in edit number (ERR_ED#) error message is output by the editor if the user 
specifies an inappropriate or bad number value in a command line. The error message may 
occur if the user did not respecif y a default value for n for a new operation after using n to 
complete a previous operation. The ERR^D# error message may also occur if the user 
attempts to use the text editor before the IT command is invoked. 
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Chapter 5 
ASSEMBLER 

5.1 INTRODUCTION 

The principal features of the assembler are as follows: 

• The syntax is a compatible subset of existing Series 32000 assemblers. 

• It accepts special syntax for register list and string instruction options. 

• It accepts symbols for PC displacements. 

• It produces optimized code for displacements entered symbolically. 

• It supports symbolic definition of global variables. 

• Input may be upper or lower case. 

• Program listing output to user terminal (default) includes line number, PC value, source 
text, and generated code. 

• Listing available for hardcopy through Parallel port or Auxiliary RS232 port. 

• Floating-point support provided through .FLOAT and XONG psuedo-ops. 

• Assembler can perform simple symbol operation necessary to create displacement table 
needed by CASE instruction. 

• All Series 32000 family addressing modes accepted. 

• Assembler accepts values in decimal (default) or hex. 

• Error messages for incorrect instructions, psuedo-ops, values, and duplicated or undefined 
symbols. 

Section 5.2 details input strings accepted by the assembler. Section 5.3 describes assembler 
commands available to the user, and Section 5.4 discusses error messages output by the 
assembler. 



5.2 VALID ASSEMBLER STRINGS 

Valid assembler input strings are characterized as follows: 
Sym.bol {htter\letter\ \letter\digitY> 

Symbols are depicted by two characters only, upper or lower case. 

No special characters allowed. 

Comment ; alpha-letters-and/or-digits 

May be alpha letters and/or digits, or empty. 
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Instruction [symbd J instruction [comment J 

An instruction is any valid Series 32000 mnemonic instruction 
with required operands. 

Pseudo-Op isymbd J Pseudo-op [comment ] 

Valid Pseudo-ops are: 

.BYTE { gn I symbdl-symbdl \ alpha-letters /digits } 

.WORD { gn I symholl-symboll] 

JX)IJBLE {gn\symboll-symbol2] 

.FLOAT rn 

XONG rn 

.BLKB {gn} 

.BLKW {gn} 

.BLKD {gn} 

.STATIC 

.ENDSEG 

A string to TDS is any of the above. It can be a symbol, an instruction, a pseudo-op or a 
comment. 

TDS symbols may be either PC-relative by labelling a code or date generation Une, or may be 
static-base-relative by using a data allocation labeL These symbols may be used only as 
arguments for PC or SB relative address modes. A simple subtraction operation is allowed for 
PC symbols in order to build a case displacement table. For data generation pseudo-ops, gn 
must be entered. For data allocation pseudo-ops, default gn = 1. The .BYTE psuedo-op may be 
used to create a string enclosed by double quote marks. 

Static base area mxost be defined as the first element of the program if the SB area is used. It 
must stort with .STATIC and terminate with .ENDSEG. 

Gn in source is assumed to be decimal. For hex values, specify IT or h'. Consult Section A.6, 
B.6, and C.6 for user notes. 



53 ASSEMBLER COMMANDS 

Two commands directly associated with assembler functions £ire Redirect Listing (RL) and 
Assemble (AS). Sections 5.3.1 and 5.3.2 list the syntax of both commands and define their uses. 
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5.3.1 Redirect Listing 

Program listings are transmitted to the user terminal. The redirat listing (RL) command 
permits the user to direct listing generation to the parallel printer port or port 1 (the auxiliary 
serial port). 

The syntax of the RL command is as follows: 

RL [lPT:|ASN:] [c] 

where: LPT: Directs the assembled listing of a source program to a 

Centronics-type parallel printer connected to the parallel port. 

ASN: Directs the listing to port 1 (auxiliary port). 

C Ends listing line S with a <CR>. Default is <CR> <LF>. 

No option cancels previously selected device. 

5.3.2 Assemble 

The syntax of the AS command is as follows: 
AS [addr] 

where: addr Begins code generation at specified hex address. Decimal values 

must be preceded by d' or D'. If addr is not specified, the 
assembler uses the next available page boundary addr. If the 
addr specified by the user conflicts with system or text data, or 
the debug table, the assembler will outjHit the BAD_MEM error 
message. 

Description: The actual assembly of source text begins when the user enters: 

AS [addr] <CR> 

The source program is assembled in two passes: Passl and Pass2. During Passl 
each line of source is displayed on the user terminal along with any assembler 
error messages. If errors are detected during Passl, the assembly is terminated 
and lists the number of errors encountered. If Passl is error free, the assembler 
starts Pass2. During Pass2, the line number, the start addres of that line, source 
text, and generated code are displayed (on the user terminal or a device specified 
by the RL command) along with any further error messages. 

It should be noted that once a source program has been successfully assembled, 
any changes in source text (using the text editor), invalidates PC and generated 
code values and debug data originally created by the assembler. This may cause 
certain debug command errors. To ensure correct operation, always reasemble 
after changing the source. 
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5^ ASSEMBLER ERROR MESSAGES 

5.4.1 Pass 1 Error Mesages 

BAD_MEM Code start addr conflicts with text or debug data. Enter a higher value 

for addr. 

BAD_SEQ Attempting to assemble null or bad text. 

BAD_INS No such instruction. 

BAD_PSU No such pseudo-op. 

ERR_VAL Bad number syntax or bad operand. 

BAD_LIN Gross line error or stand-alone label. 

ERR_SEG Using data allocation pseudo-ops within PC segment or vice versa. 

5.4.2 Pass2 Error Messages 

BAD_NUM Bad floating-point syntax or value range. 

BAD_SYM Duplicate symbol. 

UND_SYM Undefined symboL 

BAD_TAB Assembler was not initialized by IT command. 



5-4 



Chapter 6 
SYMBOLIC DEBUGGER 

6.1 INTRODUCTION 

The symbolic debugger provides the following features: 

• The ability to print or change memory locations, internal general purpose registers 
(GPR), internal special-purpose registers (SPR), and memory management unit (MMU) 
and floating-point unit (FPU) registers. 

• The ability to print or change command parameters in either hex or decimal base as 
selected by the user. 

• Program stepping. Single or multiple steps. 

• Stepping as a function of variables or register values. 

• The ability to set breakpoints. 

• Commands to dump, search and fill memory. 

• ASCII equivalent values printed along with hex memory dump. 

s The ability to create sviubolic breakrHjints usinp source defined labels. 

• Command to print the address of a symbol. 

• The ability to make symbolic changes. 

• The ability to print global memory or PC segment. 

• The ability to print register sets. 

• Error messages for unknown SVCs, external aborts, illegal user instructions, undefined 
op-codes, and memory verifications. 

Sections 6.2 through 6.S present the commands used to implement these features and detail 
the procedures required to initialize a successfully assembled source program. Note that a 
carriage return (<CR>) terminates all debugger commands. 



6.2 PROGRAM INITIALIZATION 

After a source program is successfully assembled, the program must be initialized before the 
user can actually run it or investigate its logic flow using the symbolic debugger. Program 
initialization is done manually or automatically. 

The manual initialization of an assembled program is used if an address was specified at 
assembly time and involves two basic steps. The first step encompasses the creation of a 
module table, and the second step encompasses the setting up of specific system registers. If 
the program is initialized manually, the module table should be created once for the life of 
the program while specific system registers must be set up prior to each execution of the 
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program. Section 6.2.1 outlines both procedures. 

Automatic initialization and manual initialization of a program perform the same function. 

Once the user program is properly initialized, it may be logically analyzed using the symbolic 
debugger or run. 

Sections 6.2.1 and 6.2.2 define both methods of program initialization. See Sections A.7, B.7 
and C.7 for an illustration of the TDS memory space. 



6.2. 1 Manual Program Initialization 

A module table is created using the change memory commands. The module table address 
must not corrupt source text. No system warning is given if the source text is corrupted by 
the module table inputs. Experiment with the bad memory (BAD^^EM) error message given 
at assembly time to determine valid working RAM space. The change memory commands are 
described in Section 6.4. 

A sample command sequence needed to construct a module table is as follows: 

CMD DOOO = D100 
CMD D004 = 
CMD DOOS = EOOO 
CMD DOOC = 

The first entry is the static base start address. The second entry, the link table start address, is 
set to zero since the link table is not used in this case. The third entry is the program code 
start address, and the final entry is reserved and must be set to zero. It is not necessary to 
repeat this sequence of command unless the module table is corrupted or destroyed. 

The following sample sequence of commands initializes system registers and must be entered 
in the sequence shown before each execution of the program. 

CPS = 300 
CSP = FFFO 
CFP = 
B DOOO 

The first command loads the value of the PSR required for a tiser program- The PSR is set to 
user mode. The second command loads the user stack start while the third initializes the 
frame pointer. The final command loads the user program mod register value and sets the 
user program static base register and PC. The set values become valid and in use upon entry 
into the user program by any of the program execution commands. The interrupt stack (IS) 
value must be valid if the user program will require any run-time support services. 
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6.2.2 Automatic Program Initialization 

The Begin command is used to initialize a user program if an explicit addr was not entered 
wiien the program was assembled. The syntax of the command is: 

B [Z\ mod offset] 

The Begin command loads the MOD register with mod and PC with code-start address plus 
offset. ITG also updates the SB register with a value from the module table (see Section 6.2.1 
for SB value). If an explicit assembly code start was not used, then mod and offset may be 
omitted and a module table is created beginning at PC minus H'lOO. The SB area will be on 
the first page boundary after the code. Link is set to zero. SP is set to high memory and IS is 
set to the IS area. FP is set to zero and PSR is set to 300. If the Z option is selected, memory 
from SB to SP is zeroed. 

To initiate the automatic initialization of a program, enten 
BZ 



6.3 DEBUGGER PRINT COMMANDS 

The debugger print commands are as follows: 

PM {B|W|D|F|L} {a<f<fr|5ymZ>oZ} Print memory contents of addr or symbol 

according to selected base. Byte, Word, Double- 
word, Floating-point, or Long. 

Print address of symbol. 

Print the contents of one of eight general purpose 
registers. 

Print the contents of the CPU register. 

Print the contents of the MMU MSR register. 

Print the contents of the MMU PTBO or PTBl 
register. 

Print the contents of the MMU EADDR/INVAL 
register. 

Print the contents of the MMU PFO or PFl 

register. 

Print the contents of the MMU SC register. 

Print the contents of one of 16 breakpoint 
registers. 

Print the contents of the MMU BCNT register. 

Print the contents of one of eight FPU registers. 



PAD symbol 




PR {0|1|2|3| 


4|5|6|7} 


Pcpitreg 




PMS 




PPT {0|l] 




PEI 




PPF {0|1 




PSC 




PBP {0|_.|[l5 


If]} 


PBC 




PF{0|1|2|3|^ 


\\5\6\7} 



6-3 



PFS Print the contents of the FPU status register. 

PCF Print the contents of the configuration register. 

PMM Print the contents of the main MSR register. 

AR Print the contents of all general purpose registers. 

AC Print the contents of all CPU registers. 

AM Print the contents of all MMU registers. 

AF Print the contents of all FPU registers. 

The output format of the printed data is displayed according to the base selected by the user. 
See Section 3.3.1 for more information concerning base selection. 



6.4 DEBUGGER CHANGE COMMANDS 

The debugger change commands change the contents of the corresponding user registers unless 
otherwise specified. The debugger change commands are as follows: 

CM {B|W|D} {addr\ symbol=gn] Change memory contents, at addr or symbol to an 

integer value. 

CM{F|l} {addr \ symbd=rn] Chemge contents, at specified location, to a real 

number. 

Ccpureg = gn Change the contents of the CPU register to gn. 

CMS = gn Change the contents of the MSR register to gn. 

CPT {0|l} =^gn Change the contents of the PTBO or PTBl register 

Xogn. 

CEI = gn Change the contents of the EADDR/INVAL 

register to gn. 

CSC = gn Change the contents of the MMU SC register to gn. 

CBP {0|_| [l5|f ]} = {addr\syTTnbd] Change the current addr or symbd of one of 16 

breakpoint registers to addr or symbol 

Use to 15 if radix is decimal. Use 0-F if radix is 
hex. 

CBC = gn Change the contents of the MMU NCNT register 

to gn. 

CF {0|l|2|3j4|5|7}=gw Change the contents of one of eight floating-point 

registers to gn. 

CFS = gn Change the contents of the floating-point status 

register to gn. 
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CCF = gn Change the contents of the configuration regiister to 

gn. 

CMM = gn Change the contents of the main MSR register to 

gn. 



6^ DEBUGGER EXECUTION COMMANDS 

The debugger execution commands allow the user to trace the logical flow of a program by 
using commands to conditionally run a properly assembled pr(^am. The commands available 
to the user are: STEP N INSTRUCTIONS, STEP UNTIL, STEP ^^TIILE, RUN, JUMP 
SUBROUTINE, CALL EXTERNAL SUBROUTINE, and GO. 

Sections 6.5.1 through 6.5.6 define the syntax and the usage of each command. 



u>5> X cjTEP N rNSTK«j»^iiv»i"«S vX>I1iliuaIlu 

The STEP N INSTRUCTIONS command executes a user program beginning at the current PC 
for n instructions followed by a break. If n is omitted, then default n is equal to one. The 
synux of the STEP N INSTRUCTIONS command is as follows: 

ST [n] 

6^.2 STEP UNTIL Command 

The syntax of the STEP UNTIL command is as follows: 

SU M { B I W I D } { addr | gpreg | cpureg \ gnl gn2 gnmask 

The STEP UNTIL command steps through or executes a program until the contents of memory 
at either addr, or gpreg (RO through R7), or cpureg masked with gnmask, is greater than, or 
equal to, gnl and less than, or equal to, gnl. When addr is used, BWD must be specified. 
Gnl, gnl, and gnmask are truncated to the specified BWD. For example, SU MW67900 IFOO 
FOOO EFFF means step until the next memory word. 

6^.3 STEP WHILE Command 

The syntax of the STEP WHILE command is as follows: 

SW \addr\ gpreg\cpureg} gnl gnl gnmask 

The STEP WHILE command executes a program while the memory contents of either addr, or 
gpreg, or cpureg masked with gnmask, are greater than, or equal to, gnl and less than, or 
equal to, gnl. 
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6.5.4 JUMP SUBROUTINE Command 

The syntax of the JUMP SUBROUTINE command is 
JS addr 

The JUMP SUBROUTINE command simulates the jump subroutine instruction. It calls a user 
subroutine at address addr. When the user subroutine executes the RET instruction, control is 
passed back to TDS. TDS then prompts with the B RET message. 

6.5.5 CALL EXTERNAL SUBROUTINE Command 

The syntax of the CALL EXTERNAL SUBROLTINE command is: 
CX mod offset 

The CX command is the same as the JS command but it simulates the CXP instruction. The 
subroutine address is calculated using the program address from the module table and 
subroutine offset from link table offset. B RET is issued and displayed on the user terminal 
when a return is made from the external subroutine. 

6.5.6 GO Command 

The GO command directs TDS to load the CPU internal registers and registers RO through R7, 
and then passes control to the user program. The user program runs from the current PC 
until a breakpoint or final RXP instruction is encountered. The termination of a user 
program can cause one of two end messages. B RET is issued as the end result of a return 
from a subroutine (due to the execution of a JS command) since subroutines end with the RET 
n instruction. B END is the end of the more normal B and G (Begin and Go) sequence since 
the user program ends with the RXP instruction. 

The syntax of the GO command is: 



6.6 SPECIAL PROCESSING COMMANDS 

The symbolic debugger supports the use of special commands that allow the user to move 
blocks of data from one memory location to another, fill contiguous memory locations with 
spe<:ific data, search contiguous memory locations for specific data, and dump portions of 
memory to the user terminal. 

Respectively, those commands are: MOVE BLOCK OF DATA, FILL MEMORY WITH DATA, 
SEARCH FOR DATA, and HEX MEMORY DUMP. Sections 6.6.1 through 6.6.4 present the 
syntax of each command and define their uses. 
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6.6.1 MOVE BLOCK OF DATA Command 

The syntax of the MOVE BLOCK OF DATA command is 

M addrl addrl gn 

The MOVE BLOCK OF DATA command specifies the moving of gn sequential bytes of data 
from memory location addrl to memory location addrl. 

6.6.2 FILL MEMORY WITH DATA Command 

The syntax of the FILL MEMORY WITH DATA command is: 
F addrl addrl gn [B | W | D ] 

The FILL MEMORY WITH DATA command specifies the filling of contiguous memory 
locations from addrl to addrl with data gn. The default for BWD is byte. 

6.6.3 SEARCH FOR DATA Command 

The syntax of the SEARCH FOR DATA command is: 

SR addrl addrl gn [B|W |D] 

The SEARCH FOR DATA command directs TDS to search memory from addrl to addrl for 
the first occurrence of the value gn, and print its address. If the data is not found, the E SRC 
(error search failed) debugger error message is output. The default for BWD is R 

6.6.4 HEX MEMORY DUMP Command 

The syntax of the HEX MEMORY DUMP command is: 
D addrl gn 

The HEX MEMORY DUMP command instructs TDS to dump gn memory locations, beginning 
at addrl, to the user terminal. The output is in hex with ASCII equivalents included on the 
left side of the line. 



6.7 DEBUGGER USER NOTES 

Debug command action is intended to operate only on the user memory area. That area starts 
at PC after the successful assembly of a program and after the begin command (B or BZ) is 
invoked. Failure to follow this procedure may destroy system parameters. 

The debugger supports 16 breakpoints. Breakpoints and 1 are MMU breakpoints and the 
printing/changing of BP or 1 either reads from or writes to an MMU breakpoint register. 
The remainder are software breakpoints and may be used on a development board without an 
MMU. Breakpoints are cancelled after a hardware reset. Breakpoints must be set on 
instruction boundaries for correct operation. To cancel a specific breakpoint manually, set it to 
zero. Addresses for breakpoints are taken from a successfully assembled user program by 
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vising the TP (TYPE) command to list lines of the source text The listing shows the address 
of the code, the source string, and the actual code generated. 

The commands to print/change system registers show the value of the register at the time the 
user program was run (except the INTBASE base register). The SB register value is 
printed /changed in the area pointed to by the MOD register. The SP (software register) tracks 
either the US (user stack) or IS (interrupt stack) depending on the PSR value. SP contains the 
stack address value at the last entry to TDS. 

TDS maintains two images for the MSR register. The MM (main MSR) is used during the 
time commands are issued to TDS. The MS reflects the value of MSR during the execution of 
a user program. See Chapter 8 for slave support details. 

Input/output base interpretation of debug commands is controlled by the RX command (see 
Section 3.3.1), with the exception of the Dump command (which always outputs data in hex 
format), and the print/change F/L (floating and long floating-point formats) which require 
real numbers. 

User program flow trace is provided by the action TDS takes at breakpoints or step stops. At 
these points, either a B TRC (for step command) or B n (breakpoint n) and the line number is 
displayed followed by the code address of that Une, and the source string itself. 

If a hex value is equivalent to a symbol it must start with a zero for that value to be 
interpreted as hex; otherwise it will be treated as a symboL 

If it is necessary to use explicit addresses of variables defined symbolically, use the print 
address command to obtain that value. The automatic or manual initialization of a user 
program must occur before symbols may be correctly used. 



6.8 DEBUGGER ERROR MESSAGES 

The error messages output by the symbolic debugger are summarized as follows: 

E NMI Error — non-maskable interrupt 

E NVI Error — non-vectored interrupt (not implemented) 

E FPU Error— FPU trap 

E DVZ Error — divide by zero 

E UND Error — undefined opcode (trying to use non-existing MMU or FPU) 

E FLG Error — flag trap 

E BPT Error — non-debugger BPT instruction 

E ILL Error — illegal for user instruction 

E EXT Error — external abort 

E BPR Error— MMU breakpoint 

E NST Error — MMU nonsequential trace trap 
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E ABT Error — MMU address translation 

E SRC Error — memory search fiiiled 

E SVC Error— unknown SVC 

E CXP Error — more than one call command 

E VRF Memory verify error (breakpoint could not be inserted) 



6-9 



Chapter 7 
RUN-TIME SUPPORT 

7.1 INTRODUCTION 

The principal features of the TDS run-time support are: 

1. All functions are accessed through supervisor calls (SV&). 

2. Routines are available which: 

• Support output to a Centronics-type printer. 

• Convert a binary value to an ASQI string. 

• Convert an ASQI string to a binary value. 

3. Conversions are available in decimal, hex, and long or short floating-point formats. 

The following sections define the uses and specification of each of the TDS run-time support 
functions. Chapter 8 of this manual conducts a sample user development session and presents a 
program that illtistrates the use of the run -time support routines. 

7.2 SERIAL COMMUNICATIONS 

The run-time support functions of TDS provide two SVCs that may be used by a user 
program to establish terminal I/O at port or access port 1 (auxiliary port). The two SVCs 
provide a user program with the ability to read and write buffer data from/to port or port 
1. To implement these functions, the user program must properly set up registers RO through 
R4 and execute the Supervisor Call Instruction (SVC). The following sections define the 
correct setting for registers RO through R4 for each function. See Appendices A.2, B.2, and C.2 
for further information concerning system port and port 1. 

7.2.1 Read and Buffer Serial Line Data 

R0:= 3 

Rl: = Address of buffer to be written into 

k2: = Number of characters to be read. If number is less than zero, then the 

port will be read until a <CR> is encountered, but no more than 
ABS(R2). (<CR>is counted and included in the buffer.) 

R 3: = Port to be read 

for main port 

1 for auxiliary port 

Upon return from the SVC instruction, R2 will contain the number of characters actually 
read. 
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7.2.2 Write Birffered Data to Serial Line 
R0:= 4 

Address of buffer to be read 
Number of characters to be written 



Rl 
R2 
R3: 



Port characters are to be written to 

for main port 

1 for auxiliary port 



73 NUMERICAL CONVERSIONS 

TDS run-time support provides two numerical conversion routines. An ASCII string to binary 
value conversion routine, and a binary value to an ASCII string conversion routine. The 
conversion base is user-selected to decimal, hex, or short or long floating-point. Sections 7.3.1 
and 7.3.2 list the correct setups for registers RO through R4 that the user program must 
perform. After setting up the registers, the user program issues an SVC. See Appendices A.3, 
B.3, £ind C.3 for additional numerical information- 



7.3.1 ASCn to Binary Conversion 

R0:= 5 

Rl: = Starting address of ASCII string buflFer 

R2: = Length of ASCII string (up to and including <CR>) 

R3: = Destination address of binary value 

R4: = Conversion base 

If R4 is not equal to when the conversion is completed, a conversion error occurred. 
TDS provides four conversion bases: 

Hexadecimal conversion Base = 3 



Decimal conversion 



Base = 2 



Long floating-point conversion Base = 1 
Short floating-point conversion Base = 
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73.2 Binary to ASCII Conversion 
R0:= 6 



Rl 
R2: 
R3: 



Address of binary value 

Conversion base 

Address of output character buffer (35-byte minimum capacity) 



7.4 PARALLEL PRINTER COMMUNICATIONS 

The TDS run-time support facilities provide a user program with the ability to access and use 
a Centronics- type parallel printer. The user program must set up registers RO through R2 in 
the following manner then issue an SVC: 

R0:= 7 

Rl: = Address of printable text 

R2: = Number of characters to be printed 

If bit 31 of R2 is not set, the printer routine will output a line feed every time a <CR> is 
encountered. 

If the '^rinter is not on-line when the '■'rinter routine SVC call is made the printer routine 
will wait approximately one minute, after which it will output the "check Iptf error message. 
See Sections A.4, B.4, and C.4 for specific printer interface data. 
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Chapter 8 
PROGRAM EXECUTION AND SAMPLE DEVELOPMENT SESSION 

8.1 INTRODUCTION 

This chapter describes the use of the text editor to create the source text of a sample program, 
as well as the use of the assembler to assemble that sample program and run the program. The 
chapter also presents a sample program illustrating the functions of the routines provided by 
the TDS run-time support facilities. In addition, this chapter details the TDS slave support 
facilities and presents a sample program for the MMU support. 

8.2 TEXT EDITING 

When the development board has been powered up and reset, and the IT command has been 
entered, the user may select the terminal communication mode using the CM command and 
the default base using the RX command. 

Use the text editor commands to enter the following source program into the text editor 
buffer. If the text editor buffer is empty, use the INSERT command to begin the input of 
source text- Use the other editor commands to manipulate the text as needed. The use of the 
TYPE command shows all source lines numbered and in sequence. If any of the source hnes 
are changed, the TYPE command will display the properly sequenced and updated line 
numbers. 
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;TDS DEMO PROGRAM 
;DEnNE MESSAGES 

BR AA-W 

PI: .BYTE "WRITE_$$" 
.BYTE "GET_LINE" 
.BYTE "OUTJ.INE" 

HU: .BYTE "SAY-HUH" 
.BYTE H'OD 



;CASE LIMITS 
IX: .BYTE 2 
.BYTE 



;PROGRAM START 
AA: MOVQD 3, RO 

ADDR (XSB), Rl 

MOVXBD -9, R2 

MOVQD 0, R3 
;SUPERV1S0R CALL READ 

SVC 

> 

CMPB "r, 0(SB) 

;IF ! THEN DONE 

BEQ EX:W 

MOVQD 0, R7 

BRLS:B 

LI: ADDQD 1, R7 

;PARSE INPUT 

LS: CMPMB 0(Rl), PI [R7:Ql 8 

BEQ CA:W 

CHECKBR6, IX, R7 

BFCLI 
.-OLTPUT ERROR MESSAGE 
MOVQD 4, RO 
ADDR HU, Rl 
MOVZBD 8, R2 
SVC 
BR AA 

CA: CASEW TB:B [R7:W] 
TB: .WORD WR - CA 

.WORD GT - CA 

.WORD OT - CA 
DS: .BYTE "$$$$$$$" 

.BYTE H'OD 
WR: MOVQD 4, RO 
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ADDR DS, Rl 

MOVZBD 8, R2 

SVC 

BR AA 
GT: MOVQD 3, RO 

ADDR 12(SB), Rl 

MOVXBD -9, R2 

SVC 

MOVB R2, 24(SB) 

BRAA 
OT: MOVQD 4, RO 

ADDR 12(SB), Rl 

MOVZBD 24(SB), R2 

SVC 

BRAA 
EX: RXP 
£ND OF PROGRAM 

The sample program demonstrates TDS ability to handle special instructions and provide user 
access to terminal I/O. Note that if a static base variable segment is used, it must be the first 
element of the program. 



8.3 ASSEMBLY 

Once the source text of the sample program has been entered into the text editor buffer, the 
source program is ready to be assembled- If a listing device is available, use the RL command 
to select either the auxiliary port (port l) or the parallel printer port. 

This example uses an explicit address for the beginning of the code. In this case, the Begin 
command cannot be used without an explicit mod table address. 

To assemble the program, enter the following: 

ASITEOOO 

If the address is too low, an error message will be output and the process halted. In such a 
case, enter a higher address to continue. 

Once the assembly process begins, both passes (Passl and Pass2) are displayed on the user 
terminal. 

Passl error messages are denoted by the ERR_xxx appearing on the left-most side of the screen 
to mark incorrect lines of code. By using <ctrl/S> to stop the scrolling of the display, the 
user can record the line numbers of incorrect code, and then use the <ctrl/Q>to continue the 
scrolling of the listing. If errors are detected during Passl, the assembly process is terminated 
at the end of Passl and the number of errors detected is displayed. Use the text editor 
commands to correct lines of source text that are in error. Use the same start address (HTBOOO) 
and assemble the program again. When Passl is error-free, the assembler proceeds with Pass2. 

Pass2 showsthe address of the code, the source string, the actual code generated, and any error 
messages. Use <ctrl/S> to record the line numbers of bad lines of code and use <ctrl/0> to 
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continue the listing. If errors are detected in Pass2, the assembler lists the number of errors at 
the end of Pass2. Correct any errors and use KTEOOO to assemble the program again. 

When Passl and Pass2 are completed with no errors, the program has been successfully 
assembled. The following is a sample of the listing generated. 

;TDS DEMO PROGRAM 
DEFINE MESSAGES 



OOOOEOOO 
0000E003 
OOOOEOOB 
0000E013 
OOOOEOIB 
00(X)E022 



BR AA: W 

E A 8025 

PI: .BYTE"WRITE_$$" 

57524954455F2424 

.BYTE "GET_LINE" 
4745545F4C494E45 

.BYTE "OUT_LINE" 
4F55545F4C494E45 
HU: .BYTE"SAY-HUH" 
5341592D485548 

.BYTE KTOD 
OD 



0O0OEO23 
0000E024 



;CASE LLMTTS 

1X.BYTE2 

02 

BYTEO 
00 



0000E025 
OOOOE027 
0000E02A 



;PROGRAM START 
AA: MOVQD3,R0 
DFOl 

ADDR 0(SB), Rl 
67D000 

MOVXBD -9, R2 
CE9CA0F7 



8.4 DEBUG DATA 






vu^iuiiaiiu will uiapiay uic 



line number of each line of code, the address of each line of code and the source text. The 
address of each line of code is useful for setting up breakpoints. 

If the editor commands are used to change the source text, the previously generated addresses 
and code are invalidated and the source line address will no longer appear in the display if 
the TYPE command is used. 
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Symbols as parameters will not be valid until the user program parameters are initialized. If a 
command parameter does not accept symbols, use the PAD command to obtain the explicit 
address. The following is a sample listing (using the TYPE command) output after a successful 
assembly. 

TDS DEMO PROGRAM 

DEFINE MESSAGES 

BR AA:W 

PI: .BYTE"WRITE_$S" 

BYTE "GET_LINE" 

BYTE "OUTJLINE" 

HU: .BYTE"SAY-HUH" 

.BYTE ITOD 

» 

: CASE LIMITS 
IX: -BYTE 2 
.BYTE 

; PROGRAM START 
AA: MOVQD 3, RO 
ADDR (KSB), Rl 

iVlU V A.DU ->, KZ 



0001 


; 1 DS 
;DEF 

OOOOEOOO 


0002 


OOOOEOOS 


0003 


OOOOEOOB 


0004 


0000E013 


0005 


OOOOEOIB 


0006 


00O0E022 


0007 




0008 




0009 


OOOOE023 


0010 


OOOOE024 


0011 




0012 




0013 


0000E025 


0014 


0000E027 


\J\J1J 





8^ PROGRAM INITIALIZATION AND EXECUTION 

As discussed in Chapter 6, a successfully assembled program must be initialized, either 
manually or automatically, before it can be run. The manual method entails creating a 
module table and setting up specific system registers while the automatic method performs the 
functions of the manual method automatically. 

Once the program is successfully assembled, construct the module table as described in 
Chapter 6.2.1. 

The program is now properly initialized and may be run. To run the program, enter 

G 
If WRllE_S$ is entered as follows: 

WRITE_$$ 

A string of SSSSSSS is displayed on the user terminal. 

If GET_LINE is entered and then some string of characters is input, entering OUT_LINE 
causes the character string to be displayed on the user terminal. 

Entering invalid inputs, prompts the program to display "SAY-HUIT'. 

To terminate the program and pass control back to TDS, enter ! (for done). 
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8.6 RUN-TIME SUPPORT EXAMPLES 

The following source program demonstrates the access of TDS run-time support routines by a 
user program. The program specifically illustrates the use of the numerical conversion 
routines, the printer routine, and indirectly, terminal I/O. Enter and assemble the sample 
source program. 

; THIS IS A DEMO OF TDS RTS ROUTINES 

: FOR TERMINAL I/O, NUMBER CONVERSION, AND 

; PRINTER ACCESS 



.STATIC ; DEFINE GLOBAL MEMORY 

IN: .BLKB 80 

BA: .BLKB 

PR: .BLKB 

OT: .BLKB 35 

Nl .BLKD 2 

£NDSEG 



INPUT BUFFER 

CONVERSION BASE 

FLAG TO PRINT RESULT 

RESULT BUFFER 

A BINARY NUMBER (INTERGER TO LONG FLOATING) 



BR ST:W 

LF: .WORD ITOAOD 

MS: 3YTE "ENTER A NUMBER > ' 

; PROGRAM START 

ST: MOVQD 4, RO 

ADDR MS, Rl 

MOVZBD 16, R2 

MOVQD 0, R3 

SVC 



: LF THEN CR 

; PROMPT MESSAGE 

; SET UP PARAMETERS 
; FOR SVC WRTTE 

; MAIN TERMINAL 
; OUTPUT MESSAGE 



; GET RESPONSE VIA SVC READ 

MOVQD 3, RO 

ADDR IN, Rl 

MOVXBD -80, R2 
SVC 



; RE.AD OPERATION 



80 CHARACTERS OR UNTIL CR 



; CONVERT ASCII INPUT TO A NUMBER 



Bl: 



MOVQD 5, RO 
ADDR IN, Rl 



AUUA IN 1 , K J 

MOVB BA, R4 

SVC 

CMPQD 0, R4 

BNE EX:W 
; CONVERT VALUE TO ASCII STRING 
B2: MOVQD 6, RO 

ADDRN1,R1 

MOVB BA, R2 



; LABEL FOR BP 

COUNT IS ALREADY IN R2 

DESTINATION OF RESULT 

PASS CONVERSION BASE 

GET<NUM 

CHECK FOR ERROR 

TERMINATE PROGRAM IF NOT NUMBER 
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ADDR OT, R3 

SVC ; PUT<NUM 

; WRITE TO TERMINAL CONVERTED RESULT 
B3: MOVQD 4. RO 

MOVD R3, Rl ; Rl POINT TO THE RESULT BUFFER 

MOVZBD 35, R2 ; OUTPUT THE MAX CHAR 

MOVQD 0. R3 

SVC 

ADDR LP, Rl ; OUTPUT CR LF 

MOVZBD 2, R2 

SVC 
; CHECK TO SEE IF PRINTER OUTPUT IS SET 

CMPQB 0, PR 

BEQST 

MOVQD 7, RO 

ADDR OT, Rl ; PASS POINTER TO CHARACTER BUFFER 

MOVZBD 35, R2 

SVC ; TRANSMIT CHARACTERS TO PRINTER 

ADDR LF, Rl 

MOVZBD 2, R2 ; DO A LF AND CR 

SVC 

BR ST ; REPEAT 

Once the program is successfully assembled and initialized, use the CMB command to set BA 
(the conversion base value see Section 7.3.1) and set PR to a nonzero value so that converted 
strings may be printed. Enter G <CR> and run the program. 

The program prompts with the message, "ENTER A NUMBER". 

The program converts ASCII strings to binary values (in the selected base) and places the 
value in variable Nl. The program also converts a binary value (in the selected base) to an 
ASCII string and places the string in variable OT. OT is also written to the terminal If PR is 
set, OT is written to the parallel printer using the printer access routine. 

The user can set a breakpoint at B2 (see listing) and then use the PMEM command to oberve 
the binary value of Nl. Additionally, the user can set a breakpoint at B3 (see listing) and 
observe the ASCII string at OT. 

The RL command may be used to list the outputs on a Centronics-type parallel printer 
connected to the parallel printer port, or a serial device connected at port 1. 
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Sample outputs to the printer are as follows 

Short floating-point 10000000 E -7 

Long floating-point 1000000000000000 E -15 

Decimal -12345 

Hexadecimal FFEDCBB 

8.7 SLAVE SUPPORT 

If the memory management unit (MMU) or the floating-point unit (FPU) are installed on the 
development board, TDS must be properly configured before the MMU and FPU can be 
accessed. This is accomplished by using the CCF command to properly set the appropriate bits 
of the configuaration register. Sections 8.7.1 and 8.7.2 contain further information concerning 
the FPU and the MMU. 

8.7.1 FPU Support 

Before the FPU is used, it must be reset by writing a zero to the FSR using the CFS command. 
FPU debugging is supported by the floating-point print and change function of the CMF, 
CML, PMF, PML commands, and run-time support conversions in floating-point format. 

8.7.2 MMU Support 

Setting the MMU bit in the configuration register initializes the main MSR and the user MSR 
to zero. The main MSR (accessed by "MM") must be left at zero unless the user wishes to 
experiment with supervisor mode/self translation. All debug commands require a one-to-one 
mapping for access to user variables/PC address if the user MSR (accessed by "MS") is set to 
translate. 

The following sample 10-lkie program is used to demonstrate MMU experiments. This 
program is an infinite loop that is halted by pressing the non-maskable interrupt button on the 
development board. Programs require mod table definition within the PTE and should be 
terminated by setting a breakpoint at the end. 

Create a mod table at H'9200 and set the SB st^rt to ir9030 and PC start to H'9000. Enter and 
assemble this sample code at H'9000 (a page boundary): 
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ST: 

BB: 

AA: 



MOVQD 


1, RO 


ADDD 


RO,RO 


BR 


AA:B 


ADDD 


RCRO 


ADDD 


RO,RO 


ADDD 


RO,RO 


ADDD 


RO,RO 


CMPD 


100, RO 


BLT 


ST 


BR 


BB 



To observe MMU functions in the sample program, the following steps should be taken: 

1. Use the F (fill) command to invalidate the page table area by setting it to zera 

F AOOO A600 D 

2. Set the page table base register 0. 

CPTO = AOOO 

3. Create valid page table entries. 

CMD AOOO = A407 (full access to level two at A400) 

CMD A520 = 9007 (full access to code at 9000. Note: This is indexed into 

i«,^«i '^ ♦u«+ «« ^ j„ *„ „jj_ T■pfw\n^ 

lev CI z, LiiaL L.UI i capuiiu.3 Lu acLCix n y\njyjj 

CMD A524 = 9207 (validate an area for the mod table) 

The user MMU value is set by the CMS command while the rest of the user program 
parameters are set by entering the B mod offset. The program may be started by entering a G 
command or the program may be stepped through by entering any of the step commands 
provided by the symbolic debugger. Note that the use of the step commeinds override MMU 
BP (break point) and NS (nonsequential) TRACE. 

Specific MSR values and their results are as follows: 

CMS = 10000 TU bits set. Program runs translated. 

CMS = 1810000 UT, FT, TU bits set User program-flow trace activated. 

Step through the program and use the AM command to 
see PF registers track the program. 

CMB = 710000 AI, U'B, BEN, TU bits set. MMU breakpoints (0,1) 

enabled and serviced in the abort routine. Try CBPO = 
20009004 (set enable bit) to create breakpoint. 
Breakpoint message will be E BPR. The AC command 
will verify PC value. Program may continue with a G 
or Step command. 
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CMS = 2410000 NT, AI, TU bits set. Nonsequential trap activated. 

Message is E NST. 

CMS = 10000 To observe page fault, change PTE at A520 = and 

write to invalidate register CEI = 9000. When the 
program is run, an E ABT message is issued. 
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Chapter 9 
PERIPHERAL INTERFAaNG 

9.1 mXRODUCnON 

TDS can support a number of peripheral devices 

• A parallel Centronics-type printer plugged in at the parallel port. 

• A serial device (printer or terminal) plugged in at port 1. 

• A cassette tape recorder plugged in at the parallel port. 

Sections 9.2 through 9.4 discuss each peripheral device serviced; see Appendices A, B, and C 
for specific data. 

9.2 CENTRONICS-TYPE PARALLEL PRINTER 

A Centronics-type parallel printer plugged in at the parallel printer port provides the user 
with hard copies of prc^ram listings. 

See Sections A.4, R4, and C4 for interface cable pins-outs and other cable specification and 
construction information. 

9.3 SERIAL COMMUNICATIONS 

TDS supports serial communications with a printer or a terminal at port 1. 

Sections A.1, A.2, B.1, R2, CI, and C.2 contain information on the procedures required to set 
the baud rate of ports and 1. 

9.4 CASSETTE RECORDER 

TDS supports the storj^e of source programs on cassette tape and the retrieval of source text 
from the cassette tape. The following sections provide information on the TDS commands used 
to save and retrieve source programs, the use of the recorder, the cassette interface cable, and 
error messages. 
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9A.1 Data Storage and Retrieval 

Two TDS commands support the storage and retrieval of source programs. They are: the Tape 
Write and Tape Read commands. 

The syntax of the Tape Write command is as follows: 

TW [@n] [addrl addr2] <CR> 

If addrJ and addr2 are specified, data is read from the addr] location (in TDS memory) to the 
addrl location, and written to the cassette tape. If addrl and addrl are not specified, the 
entire contents of the text buffer is written to the cassette recorder. The text buffer contains 
text entered at the user terminal. 

@n is interpreted as a decimal value that is used to generate the required timings for a write- 
to-cassetle tape operation. The default value is for a 7-MHz frequency since the CTTL on the 
development board may range from 6-10 MHz. If a development board is equipped with a 
crystal other than 12 MHz, the following formula can be used to compute @n. 

n= 14 X CTTL 
where CTTL = 1/2 (crystal frequency) 

See Sections A.5, R5, and CJ for further information on the cassette interface timing data, 
and on the method of using an oscilloscope to set a value for @n. 

The syntax of the tape read command is as follows: 

TR [addr] 

If addr is specified, data read from the cassette tape is stored beginning at the location in TDS 
memory specified by addr. If addr is not specified, it is assumed that the data to be read is a 
source program and is loaded into the text editor buffer. 

9.4.2 Cassette Interface Cable 

The cassette interface cable is used to connect the cassette recorder to the parallel printer port. 
One end of the cable should contain two audio connector plugs for connection to the cassette 
recorder and the other end must contain a 100-pin connector for connection to the parallel 
printer port See Sections A.5, B.5, and C.5 for complete details on the construction of the 
cassette interface cable. 



9.4.3 Recorder Use 

If the cassette tape to be used is not new, or has been read from twenty times, it should be 
erased twice before it is used. The volume control on the recorder should be set at maximum 
at all times. 

To write data to the cassette recorder, the cassette interface cable must be connected to the 
parallel printer port and the auxiliary out or earphone jack of the cassette recorder. Start the 
recorder and leave a 20-second silent header on the tape and then (at the user terminal) enter 



TW [@n ] addrl addrl 
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to begin the write-to-tape operation. Avoid stopping the recorder while the data operation is in 
progress. At the completion of the operation, TDS is returned to the CLI mode. 

To read data back from the recorder (assuming the recorder is cabled up properly), start the 
recorder and enter 

TR [addr] 

on the terminal but do not press <CR>. When the tape is past the plastic leader, press <CR> 
to start the read-from-tape operation. At the completion of the operation, TDS is returned to 
the CLI mode. 

Error messages output by TDS alert the user to any errors detected during either data 
operation. 



9.4.4 Recorder Error Messages 

The error messages output by TDS that support write-to-tape and read-from-tape operations 
are summarized as follows: 

TLM_OUT No data pulses present. This message occurs 

approximately 90 seconds after a data operation is 
initiated if no data pulses are detected. 

BAD_FRM Bad tape format. Attempted to read data that does not 

conform to the established data format. 

CRC_ERR A CRC error was detected. 



9.5 NEW COMMANDS FOR TDS ON THE DB32O00 AND DB32016 

TDS for the DB320(X) and DB32016 has four new commands that allow it to access either 
RS232 port to communicate with a host system for use of that host's mass storage facilities, i£., 
floppy disks in the case of a PC. 

With these commands the user can either send or receive from the host the contents of or for 
the TDS edit buffer or any memory range. 

Data is transferred in a special format. TDS uses the ASQI-hex format to represent a binary 
value. For 'instance the character "A" has a hexadecimal byte value of H'41. TDS will convert 
this "A" to two ASCII characters, "41", representing H'41 before it is sent to a host A null 
byte (H'OO) is converted to "(X)", and so on. The reverse occurs upon receipt of data from a 
host, i£., two bytes of character are converted to one byte of data stored either in the text 
buffer or in memory. 

The record format is: 

>hl h2h 3_.h 1 6end-of -record <CR > 

Every record starts with the character ">", followed by 16 ASCII-hex number values. (16 of 
these equal 8 physical bytes.) The record is terminated by writing/reading a carriage return 
(<CR>). If the amount of data sent/received is not an even multiple of 16 bytes, the final 
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record is padded with null ASCII-hex characters. 
End of record format: 

An end of record is indicated by a solitary "<" character followed by a carriage return. 
Handshake character: 

Wherever handshake is mentioned, the sync character used is the asterisk "*". 

9^.1 Read Data In From Port 

ZI { F I S } { M I A } [startaddr endaddr ] 



ZI 




read data in 


F 




no handshake 


S 




handshake 


M 




main port 




A 


auxiliary port 



If addrs not specified then assume text data and init edit buflFer else fill mem from startaddr 
to endaddr. 

Specifing addrs gives you two choices. If endaddr is less than EOF on the host the command 
receive process will terminate upon reaching endaddr. The host transmission program will be 
deadlocked if handshake was specified. Typically specify endaddr as some big value like 
h'f f f f f f and let EOF terminate command. 

Basic protocol on TDS end is to read data until a <CR >, process it and output a sync character 
(*) if handshake option was selected. Continue until the first character in line is the "<" 
character signifying EOF. 



9^.2 Write Data Out To Port 

ZO { F I S } { M I A } [startaddr endaddr ] 
ZO send data out 

F no handshake 

S handshake 

M main port 

A auxiliary port 

If addresses are not specified, the contents of edit buffer is sent from startaddr to endaddr. 

Basic protocol is to read the sync character "*" + <CR>then sent one record; continue until 
done. Send EOF character "<". If handshake not selected, omit the read. 
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9^.3 The AT R Command 

@R [6cw<f] The @R command will program the auxiliary port (port l) to the 

specified baud rate. Baud rate is entered as a byte-long hexadecimal 
value corresponding to dip switch pattern (see Sections B.2 and C.2 in 
Appendices B and C for baud rate setup). If baud rate is omitted then 
the dip switch is read and the baud rate determined from the found 
pattern. (At reset the auxiliary port is programmed to the same speed as 
main according to the dip switch.) This command was added since the 
DB320(X) and the DB32016 can have independently set port speeds. Also, 
the ZI, ZO commands would probably be used with a host connected to 
the auxiliary port, but running at a slower speed than the terminal. 

NOTE: On the DB32016 the auxiliary port USART must be 
driven by the 8253 timer. This is the only way to 
have board run the two ports at different baud rates. 



9^.4 The AT M Command 

@M [memaddr^ This command will set high memory value for use by TDS. After the IT 
command, high mem is set to ITTf f f f (512K) for DB32000. It is set to 
27FFF for DB32016 (128K + 64K). During assembly TDS will search 
memory space up to this default value to find the real end of memory 
which would depend on the type of mem chips loaded in the board. 
(Top of mem is used by the TDS assembler for symbol table creation and 
is also the value used by the auto B command to set users SP.) If 
memaddr is specified, that value will be used as top of memory. This 
command should be used with caution since there is no checking for 
validity. If memaddr is omitted then the TDS is reset to search for high 
mem in the same fashion as after the IT command. 

NOTE: The IT command nulls any previously entered 
memaddr value. This command was added to 
preclude the possibility of TDS affecting off-board 
memory. User is responsible for his/her particular 
configuration and should be aware of performance 
tradeoffs due to off-board memory access and non- 
aligned stack pointer. 
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Information Common To ZI and ZO 

If using the main port, it may be necessary to use the operating mode command (OM) to set 
terminal characteristics. Use QMS to eliminate LPs. 

Start TDS command first, then start host program, unless doing a no-handshake transmit to 
host. In this case, start the host end first. A fast (no-handshake) transmit on the main port is 
not possible. 

For every record sent/received a period is written to the user terminal unless user is using the 
main port in which case this is suppressed. When using main, error messages are not 
suppressed. The host program should be aware of this. 



Error Messages 

BAD_SYN Received wrong sync character 

BADJVtEM Specified forbidden memory, TDS variables, edit bufi'er, etc. 

BAD_FRM Received data in unknown format 

9^.5 Sample Prc^am 

The following is a sample Pascal program required for the host to communicate with TDS. 

NOTE: For both send and receive procedures, a single period is written to the host 
console for every record sent/received. This is a visual indicator that the 
line is responding to data transfers and is not deadlocked. 

PROGRAM TDSCOMPCXINPUT, OUTPUT, DATA); 



(* 



This Pascal program illustrates the required communication protocol to send/receive over TDS 
controlled RS232 ports. 

This Pascal is not standard. There are references to host-system-dependent I/O functions such 
as "open" and "close." 

Changes may be necessary depending on system implementation of Pascal READ/READLN, 
WRITE/WRITELN and structure of TEXT file as opposed to FILE OF CHAR. In this instance, 
LINEOUT was declared as FILE OF CHAR in order to eliminate the OS-generated linefeed 
sent with every carriage return if LINEOUT was TEXT. 
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CONST CR = 13; 

VAR lOBUF 

HLENAME 
LINEIN 
LINEOUT 
DATA 



PACKED ARRAY[1_130] OF CHAR ; 
PACKED ARRAY[1_30] OF CHAR ; 
TEXT; RS232 input 

FILE OF CHAR; RS232 output 
TEXT; Host-resident file 



COUNT, AMOUNT, 

DOT : INTEGER ; 

FAST, TOTDS 

DONE : BOOLEAN ; 

CH : CHAR ; 



PROCEDURE START; 



(* This procedure will set Boolean variables for handshake, and data transfer 
direction, and will ask for the name of a host resident file. The host file will 
be created if data is from TDS. *) 



BEGIN 



WRITELN; WRlTECHandshake? (<Y>es or <N>o) >'}, 
REAIXCH); READLN; 



WRITELN; WRITECName of data file?) ; 
READLNCFILENAME) ; 

WRITELN ; WRITE(T)irection of transfer? <T>o TDS or <F>rom TDS >'>, 

READ(CH>JIEADLN; 

IF CH = T THEN TOTDS := TRUT ELSE TOTDS := FALSE; 

WRITELN; 

IF TOTDS 

(* System-dependent file handling routines *) 

THEN BEGIN OPENCDATA, FILENAME, HISTORY:=OLD) ; RESEItDATA) END 
ELSE BEGIN OPENtDATA, FILENAME, HISTORY:=NEW) ; REWRITE(DATA) END 

END; 

PROCEDURE SEND ; 

BEGIN 

(* System dependent line and file opens *) 
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IF NOT FAST 
THEN BEGIN 

OPENCLINEIN, 'LINEIN') ; 

RESET(LINEIN) ; 

END; 
OPEN(LINEOUT, 'LINEOUD ; 
REWRITE(LINEOUT) ; 

DONE := FALSE: DOT :=0; 

(* Main loop *) 

REPEAT 

(* Read a line of data *) 

READLNCDATA, I0BUF>, 

IFIOBUHl] = '>' 

(♦ If record starts with '>' then write 33 characters *) 

THEN AMOUNT := 33 
(* Else write only 1, the '<' character, and set done flag true *) 

ELSE BEGIN AMOUNT := 1; DONE := TRUE END: 
COUNT := 1; 

REPEAT 

(* Write one char at a time *) 
CH : = lOBUHCOUNT] ; 
WRITE(LINBOUT,CH) ; 
COUP^JT := COUNT + 1 ; 

UNTIL COUNT > AMOUNT ; 

(* Count number of records written in DOT^ *) 

DOT := DOT + 1 ; 

WRITECV;^ 
(* Check if a new dot line should be started *) 

IF DOT > 60 THEN BEGIN DOT := 0; WRITELN END; 
(* Flush out the host buffer by writing a <CR > 

THIS MAY BE HOST DEPENT)ENT! *) 

WRITE(LINTC)UT, CHR(CR)) ; 
(* If no handshake then do not send sync char *) IF NOT FAST THEN BEGIN 

readuvClinein, iobuf:^ 

CH := lOBUHl]; 

IF CH <> '*' THEN WRITELNCSYNC ERROR'); 

END; 

UNTIL DONE 

(* End main loop *) 
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IF NOT FAST THEN CLOSE(LINEIN) ; 
CLOSE(LINEOUT) ; 
CLOSECDATA) ; 
ENI^ 

PROCEDURE RECV; 
BEGIN 

(* System dependent line and file opens *) 

open(lint;in, TINEINO ; 

RESETCLINTIN) ; 
IF NOT FAST 

THEN BEGIN 

OPEN(LINBOUT, LINEOUT) ; 

REWRITECLINEOUT) ; 

END; 

(* Main loop *) 

REPEAT 

(* If handshake then write sync char *) 
IF NOT FAST THEN WRITE(LI>JEOUT, **', CHR(CR)); 

(* Read in line from TDS *) 
READLNCLINHN. I0BUF>, 

(* Determine if a record or end of data *) 
IF lOBUFtl] = '>' 

THEN AMOUNT := 33 ELSE BEGIN AMOUNT := 1; DONE := TRUE END: 
COLTVT :=1; 
(* Write to host file, one char at a time *) 
REPEAT 
CH := lOBUFlCOUrsfT] ; 
WRITE(DATA,CH) ; 
COUNT := COUNT + 1; 
LTSFTIL COUNT > AMOUNT; 
(* Set host file eol *) 
WRITELN(DATA>, 

DOT := DOT + 1; 

WRITEC.'); if dot > 60 THEN BEGIN WRITELN^ DOT :=0 END; 

UNTIL DONE: 

(* End main loop *) 
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IF NOT FAST THEN CLOSECLINEOUT); 

CLOSE(LINEIN); 

CLOSE(DATA); 

END 

BEGIN (*Main procedure*) 

START ; 
IF TOTDS 
THEN SEND 
ELSE RECV; 
ENE^ 
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Appendix A 
TDS ON THE DB160(X) 

A.l AUXILIARY PORT BLX-351 SETUP PROCEDURES (DB16000) 

Gang Mode: (BLX-351 rate is main port rate) 
On the BLX-351 

1. Remove berg connector between E29 and E30. 

2. Remove berg connector between E27 and E28. 

3. Wire wrap E25 to E27 to E29. 
On the DB 16000 

1. Close W12 pins 3 to 4. 

2. Mount BLX-351 at J3. 

Independent Mode: (Program the 8253 on the BLX-351) 
On the BLX-351 - (Factory configuration) 

A T T-"^n -—J 1-"^/^ 

1. jumper czy anu c.j\j 

2. Jumper E27 and E28 

On the DB 16000 

1. Assuming that the TDS system is powered up, reset, and initiahzed, enter the 
following sequence of commands to program the 8253: 

CMB C00056=B6 ;8253 mode control 
CMB C00054=40 ;LSB of count divisor 
CMB C00054=00 :MSB of count divisor 

This sequence of commands sets the BLX-351 to run at 1200 baud. 

The general formula for divisor is: 

d = 76800/BAUD 

Convert d to hex format. Enter LSB first A MSB must be entered if MSB = 0. 
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A.2 BAUD RATE SETUPS (DB16000) 

The following dip switch settings on the DB16000 control the baud rates of port and port 1. 
S4 S3 82 SI Baud Rate 



on 


on 


on 


on 


19200 


on 


on 


on 


off 


9600 


on 


on 


off 


on 


7200 


on 


on 


off 


off 


4800 


on 


off 


on 


on 


3600 


on 


off 


on 


off 


2400 


on 


off 


off 


on 


2000 


on 


off 


off 


off 


1800 


oif 


on 


on 


on 


1200 


off 


on 


on 


off 


600 


off 


on 


off 


on 


300 


off 


on 


off 


off 


150 


off 


off 


on 


on 


134 


off 


off 


on 


off 


110 


off 


off 


off 


on 


75 


off 


off 


off 


off 


50 



Switches 5, 6, 7 and 8 are unused. 

NOTE: Programming is possible only on a DB16000 equipped with an ICU. 

A.3 NUMERICAL DATA (DB16000) 

Integer Ranges and Data: 

Decimal -2147483648-21474836647 

Hex 0-.FFFFFFFF 

• No equivalence checking. 

• No overflow checking in ASCD to binary conversion. 

• Syntax checked in ASCII to binary conversion. 

• Hex output interpreted as unsigned. 

• Decimal treated as signed for binary to ASCII conversion. 

• Decimal treated as signed or unsigned depending on the value in an ASCII to binary 
conversion. 

• Numbers too large for operand size are truncated in the high bits. 



A-2 



Floating-Point Ranges 

Long max =16 digits ± 307 exponent range 
Short max = 8 digits ± 37 exponent range 

Floating-Point Accuracy: (Conversion with no arithmetic operation) 

Long format: 16 digits ± 2 LSD 

14 digits ± .5 LSD 

Short format: 8 digits ± 2 LSD 

6 digits ±.5 LSD 

Floating-Point Errors: 

Syntax and range checking for ASQI to binary conversions. 
No NaN recognition for binary to ASCII conversion. 

A.4 PARALLEL PRINTER INTERFACE DATA (DB16000) 

The parallel printer port supports a Centronics or an equivalently strobed printer. This 
information is provided for the user who wishes to construct a printer interface cable. In this 
case, a high quality twisted-pair cable is mandatory. However, it is advisable to use the SPX 
Centronics printer interface cable (pjirt number 601304044-001). 

Shown below are the signal pin-outs for the printer interface cable. 
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DB16000 100-PIN EDGE 36-PIN D PRINTER 

PARALLEL PORT CONNECTOR CONNECTOR SIGNAL NAMES 

47 A24 11<29> BUSY (From Printer) 

37 A19 13 SELECTED (From Printer) 

23 A12 2<20> DATA 1 (To Printer) 

2] All 3<21> DATA 2 (To Printer) 

19 AlO 4<22> DATA 3 (To Printer) 

17 A09 5<23> DATA 4 (To Printer) 

25 A13 6<24> DATA 5 (To Printer) 

27 A14 7<25> DATA 6 (To Printer) 

29 A15 8<26> DATA 7 (To Printer) 

31 A16 9<27> DATA 8 (To Printer) 

15 A08 1<19> STROBE (To Printer) 

Bn ground < n > ground 

The software driver logic is compatible with U4 as a 8303 and XU6, XU7, and XU8 as 7437. 

Ensure that U4 is selected in receive mode (berg connector across 1-2 at Wll). 



A^ CASSETTE INTERFACE DATA (DB16000) 

CASSETTE INTERFACE CABLE 

The cassette interface cable can be constructed from readily available components. It is 
connected to the auxiliary out or earphone jaci. of a cassette recorder and the system parallel 
port. Additionally, interface circuitry is required at the connector to the parallel port. The 
diagram illustrates the hardware requirements at both ends of the interface cable. The 
components required for the parallel port interfacing are presented in the parts listing. 
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+5v 



DATA BIT IN 
(BIT 0) 



DB16000 




DATA BIT OUT 
(BIT 0) 



NOTE ON DB16000 Jl 2-50 
ARE 6ND 




4.7k 



JI-47 



Jl-15 



SPECIAL SIMPLE CASSETTE INTERFACE 
CONNECTED TO Jl 

FROM RECORDER 
EARPHONE OR 




2N2222 



Ik 



Ik 



AUX OUT 



Uf 



1 



GND 



ZZ GND 



2.2k 



22* 



PARTS UST 



SHIELDED CABLE 
^1 TO RECORDER INPUT 



ZI GNU ~ 



FC-Ol-O 



QTY 



DESC 



1 


2N2222 Transistor 


2 


IK Resistor 


1 


2.2K Resistor 


1 


22 ohm Resistor* 


1 


.1 microfarad Capacitor 


2 


Audio Connector Plugs 


1 


100-pin connector 



*This value may be dependent on the particular recorder used. 

INTERFACE TIMING DATA 

Timing data is provided to aid the user in calculating the value of @n as it is used in the TW 
(tape write) command, for board frequencies other than 14 MHz. 

The timings generated by the program produce a serial data flow rate of approximately 330 
baud. The effective recording frequency is approximately 660 Hz. The diagram illustrates the 
timings of pulse waveforms. 
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T 



CLOCK PERIOD 



DATA PERIOD 



Tp 



Tw 



HI=1 
L0=0 

Tp 



Tw 



-// 



BAUD RATE 



2xTw 



FC-02-0 



OUTPUT PUXSE TIMING: (At UXl pin 11) 

Tp = .500 ms ± 10% 
Tw = 1.5 ms ± 10% 
Vhi = TTL level Voh 

Input to the recorder at the voltage divider should be 20-100 mV depending on the recorder 
used. The user may connect an oscilloscope probe to pin 11 of UX7 and then use the TW 
command to enter trial values for n until the output pulse timing shown in the diagram is 
observed. 

INPUT PULSE TIMING: (At U4 pin 8) 

Tp = .280 ms minimum 
Tw = 1.5 ms ±10% 
Vhi = TTL level Voh 

This waveform can also be observed at the tape header or by recording binary data with all 
bytes set to -1, and then by reading the data back. 



A.6 ASSEMBLER USER NOTES 

The assembler was written to be as consistent as possible with available assembler 
documentation, but due to its compactness, certain exceptions must be observed. Those 
exceptions are listed below. 

1. ASCII strings are delimited by double quotes only. 

2. Symbols are valid for PC address and SB segment mode only. 

3. Symbols must contain only two characters. 

4. The only operation allowed is subtraction between symbols. 
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5. Strings are valid only for .BYTE Psuedo-op and immediate operands. 

6. RO through R7 are the only recognized register mnemonics. All others must be hex 
encoded. 

7. CXP argument is simply n. 

8. CBITIi and SBITIi instructions are not implemented. 

9. Registers RO through R7 must be used for FO through F7. 

10. Immediate floating-point values not allowed. 

11. The STATIC area must be declared as the first element of the program. 

12. Pseudo-ops parse on first four characters only. 

13. All lower case characters in the string of .BYTE will be changed to upper case 
during assembly. 

14. LXPD instruction not implemented. Use ADDR EXT(n), DESTPCATION. 

The assembler does not fully support operand legality-checking, value range checking, and 
some soft parsing. Immediate operand values are truncated and no error message is issued. 

Certain parsing errors such as balanced parentheses are not checked. Characters other than 
those allowed by syntax rules are not checked for and may not output an error menage. 



A.7 TDS MEMORY MAP (DB16000) 

The diagram is a graphic representation of the memory space available to TDSs. 
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ADDR 



PROM 
RANGE 



RAM 
RANGE 



In auto mode 
user module 
table is 



H'3FFF 



H'8000 





IDS 




Code 


<-H'3F0S 


TDS Module table 


<-H'3FCS 


TDS Interrupt and Trap uble 





IDS variables 


<-H'8200 






i DS stack 


<-H'8500 




<-H'8600 


User IS 


<-Pr8700 


IDS variables 





// // 




<-x = W600 + # of characters in source 




+ 9*(# of lines in source) 


> 


<— @ first available 1/2 page boundary * 


> 


<— @ first available page boundary 


> 


<— @ first available page after code 


> 


<— @ Highest mem addr - 7 (rxp pushed onto stack) 



User Code is 
User Static base 
User SP 



♦Unless memory available is greater than or equal to 64K, the module table is constructed 
within the reserved system area. 



A.8 TDS ERROR SUMMARY (DB 16000) 

TDS system error messages are summarized as follows: 

BAD_TXT Bad text input. 

ERR ED# Error in edit number. 



BAD_MEM 
BAD_SEQ 



Code start addr conflicts with text or debug data. Enter a higher 
value for addr. 

Attempting to assemble null or bad text. 
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BADJNS 

BADJ'SU 

ERRJi-'AL 

BADJ.IN 

ERR^EG 

BAD_NUM 

BAD_SYM 

UND_SyM 

BADJTAB 

ENMI 

EN\n 

EFPU 

EDVZ 

EUND 

E FLG 

EBPT 

EILL 

EEXT 

EBPR 

ENST 

EABT 

ESRC 

ESVC 

ECXP 

EVRF 

TIM_OUT 

BADJ^RM 
CRC ERR 



No such instruction. 

No such Psuedo-op. 

Bad number syntax or bad operand. 

Gross line error or standalone label. 

Using data allocation Psuedo-ops within PC segment or vice versa. 

Bad floatmg-point syntax or value range. 

Duplicate symbol. 

Undefined symbol. 

Assembler was not initiated by IT command. 

Error - Non-maskable interrupt. 

Error - Non-vectored interrupt (not implemented). 

Error - FPU trap. 

Error - divide by zero. 

Error - undefined op-code (trying to use non-existing MMU or 
FPU). 

Error - flag trap. 

Error - non-debugger BPT instruction. 

Error - illegal for user instruction. 

Error - external abort. 

Error - MMU breakpoint. 

Error - MMU non-sequential trace trap. 

Error - MMU address translation. 

Error - memory search failed. 

Error - unknown SVC. 

Error - more than one call command. 

Memory verify error (breakpoint could not be inserted). 

No data pulses present. This message occurs approximately 90 
seconds after a data operation is initiated if no data pulses are 
detected. 

Bad tape format. Attempted to read data that does not conform to 
the established data format. 

A CRC error was detected. 
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A.9 TDS CX)MMAND SUMMARY (DB16000) 

The commands iised in the TDS system are summarized as follows: 



RX {H|D} 

OM gn 

IN [n] {string} 

TP [nJ [/n2]] 

RP n { string } 

Kn 

RS 

RL [LPT:|ASN:] [c] 

AS [addr] 

B [Z\mod offset] 



PM {B|W|D|F|L} {addr\symbol} 

PAD {symbol} 

PR {0|1|2|3|4|5|6|7} 



1 o i/wr c^ 



PMS 

PPT {0|l} 

PEI 

PPF {0|l} 



Select the system base to be hexadecimal or 
decimal. 

Set the terminal communications mode. See 
Section 3.3.2. 

Insert string above or after line n of the text 
buffer. 

Type line nJ of text buffer or type n2 hnes 
of buffer beginning with nl. 

Replace line n of buffer with string. 

Kill or delete line n from text buffer. 

Reset clear text buffer. 

Redirect listing from terminal to printer at 
parallel port or serial device at port 1, and 
end listing with a <CR> or cancel 
previously selected device. 

Begin the assembly of user program at 
address addr. 

Initialize a user program if an explicit 
address was used as assembly time. If an 
explicit address was not u^d, mod zind offset 
may be omitted. The Z option zeros memory 
from the SB to the SP area. 

Print memory contents according to selected 
base. Byte, Word, Double-word, Floating- 
point or Long. 

Print address of symbd. 

Print the contents of one of eight general 
purpose registers. 

Print the contents of the MMU MSR register. 

Print the contents of the MMU PTB register. 

Print the contents of the MMU 
EADDR/INVAL register. 

Print the contents of the MMU PF register. 
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PSC 

PBP {0|„|[l5|f]} 

PBC 

PF {0|1!2|3|4|5|6|7} 

PFS 
PCF 

PMM 
AR 

AC 
AM 

AF 

CM {B|W|D} {addr\symbol=gn} 

CM {F|L} {addr\symbd=rTi} 

Ccpureg= {gn} 
CMS= {gn} 

CPT {0|l}=gn 

CEl = gn 

CSC = gn 

CBP {0|„.|[l5|f]} = {addr\ symbol} 



CBC = gn 



CF {0|1|2|3|4|5|7} ^ gn 



Print the contents of the MMU SC register. 

Print the contents of one of 16 breakpoint 
registers. 

Print the contents of one of the MMU BCNT 
registers. 

Print the contents of one of eight FPU 
registers. 

Print the contents of the FPU status register. 

Print configuration. 

Print the contents of the main MSF register. 

Print the contents of all genera] purpose 
registers. 

Print the content*! nf all CPI 1 r<>oiet(>rc 
- -- -- - _ ^-^-.^. ... 

Print the contents of all MMU registers. 

Print the contents of all FPU registers. 

Change memory contents, at specified 
location, to an integer value. 

Change memory contents at addr or symbd 
to a real number. 

Change contents of the CPU register to gn. 

Change the contents of the MSR register to 
gn. 

Change the contents of the PTB register to 
gn. 

Change the contents of the EADR/INVAL 
register to gn. 

Change the contents of the MMU SC 
register. 

Change the current addr or symbol of one of 
sixteen breakpoint registers to addr or 
symbol. 

Change the memory contents of the MMU 
NCNT register to gn. 

Change the memory contents of one of eight 
FPU registers to gn. 
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CFS = gn 
CCF = gn 
CMM = gn 
ST[/i] 

SU { addr | gpreg \ cpicreg } gnl gn2 gnmask } 



SW { addr | gpreg | cpureggnl gnl gnmask } 



JS addr 

CX mod offset 

GO 

M addr I addrl 



F addrl addrl gn [b | W | D ] 
SR addrl addrl gn [B | W | D ] 



D addrl gn 



TW [@n] [addrl addrl] 



Change the memory contents of the 
floating-point status register to gn. 

Change the memory contents of the 
configuration register to gn. 

Change the memory contents of the main 
MSR register to gn. 

Step through the user program for n 
instructions and then break. Default for n is 
one. 

Step through a user program until the 
contents of memory at addr, or gpreg (RO- 
R7), or cpureg masked with gnmask, is 
greater than or equal to gnl and less than or 
equal to gnl. 

Step through a user program while the 
memory contents of either addr, or gpreg, or 
cpureg masked with gnmask, are greater 
than or equal to gnl and less than or equal 
to gnl. 

Call a subroutine at location addr. 

Call external subroutine at address 
calculated using mjod and offset from the 
module table. 

Begin program execution. 

Move gn sequential bytes of data from 
memory location addrl to addrl. 

Fill memory locations from addrl to addrl 
with data gn. 

Search memory between addrl and addrl 
for data gn and print its address according to 
BWD. 

Dump gn locations beginning at addrl, to 

CjLi.1- UOCl LCl XlJ.X.U.UJk* 

Write data between location addrl and 
addrl to the cassette recorder. Otherwise, 
write contents of editor text buffer to the 
cassette recorder. @n specifies timings for 
boards not equipped with a 14 MHz crysUl. 
See Chapter 9.2 for details. 
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TR [cufdr] Read data from the cassette tape and store it 

in memory beginning at location addr. 
Otherwise, load the data into the editor text 
buifer. 
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Appendix B 
TDS ON THE DB32016 

B.1 AUXILIARY PORT SETUP PROCEDURES (DB32016) 

As shipped the DB32016 is configured to run at 9600 baud at reset independent of the dip 
switch. Follow this jumper change sequence to allow port programability. 

MAIN PORTO (J2) AUX PORTl (J3) 

W2] 9-10 Closed W21 7-8 Closed 

W 34 4-5 Open W29 4-5 Open 

W34 5-6 Closed W29 5-6 Closed 

At reset the configured port will run at baud determined by the dip switch (see Section B.2). 
If auxiliary port is so configured, it can be independently programmed by use of the @R 
command. 

B.2 BAUD RATE SETUPS (DB32016) 

The following dip switch settings on the DB32016 control the baud rates of port and port 1. 
S4 S3 S2 SI Baud Rate 



on 


on 


on 


on 


19200 


on 


on 


on 


off 


9600 


on 


on 


off 


on 


7200 


on 


on 


off 


off 


4800 


on 


off 


on 


on 


3600 


on 


off 


on 


off 


2400 


on 


off 


off 


on 


2000 


on 


off 


off 


off 


1800 


ofi^ 


on 


on 


on 


1200 


off 


on 


on 


off 


600 


ofi^ 


on 


off 


on 


300 


oif 


on 


off 


off 


150 


off 


off 


on 


on 


134 


off 


off 


on 


off 


110 


off 


off 


off 


on 


75 


off 


off 


off 


off 


50 



Switches 5, 6, 7 and 8 are unused. 
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NOTES: 1. Required terminal characteristics 

a. Parity - disabled 

b. Stop bits = 1 

c. Character length = 8 bits 

2. Port 1 (auxiliary) may be independently programmed using @R 
command (see Section 9.5.3). 

3. To calculate @R value, 0N=0, 0FF=1. 

B.3 NUMERICAL DATA (DB32016) 

Integer Ranges and Data: 

Decimal -2147483648-21474836647 

Hex 0_FFFFFFFF 

• No equivalence checking. 

• No overflow checking in ASCII to binary conversion. 

• Syntax checked in ASCII to binary conversion- 

• Hex output interpreted as unsigned. 

• Decimal treated as signed for binary to ASCII conversion. 

• Decimal treated as signed or unsigned depending on the value in an ASCII to binary 
conversion. 

• Numbers too large for operand size are truncated in the high bits. 
Floating-Point Ranges: 

Long max = 16 digits ± 307 exponent range 
Short max = 8 digits ± 37 exponent range 

Floating-Point Accuracy: (Conversion with no arithmetic operation) 

Long format- 16 digits ± 2 LSD 
14 digits ±.5 LSD 

Short format: 8 digits ± 2 LSD 
6 digits ±.5 LSD 

Floating-Point Errors: 

Syntax and range checking for ASCII to binary conversions. 
No NaN recognition for binary to ASCII conversion. 
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B.4 PARALLEL PRINTER INTERFACE DATA (DB32016) 

The parallel printer port supports a Centronics or an equivalently strobed printer. This 
information is provided for the user who wishes to construct a printer interface cable. In this 
case, a high quality twisted-pair cable is mandatory. However, it is advisable to use the SPX 
Centronics printer interface cable (part number 601304044-001). 

Shown below are the signal pin-outs for the printer interface cable. 

DB32016 100-PIN EDGE 36-PIN D PRINTER 

PARALLEL PORT CONNECTOR CONNECTOR SIGNAL NAMES 

48 A24 il<29> BUSY (From Printer) 

38 A 19 13 SELECTED (From Printer) 

24 A12 2<20> DATA 1 (To Printer) 

20 AlO 

18 A09 

26 A13 

28 A14 

30 A15 

32 A16 

16 A08 

Bn ground 

The software driver logic is compatible with U4 as a 8303 and XU6, XU7, and XU8 as 7437. 
Ensure that U4 is selected in receive mode (berg connector across 1-2 at Wll). 



4<22> 


DATA 3 (To Printer) 


5<23> 


DATA 4 (To Printer) 


6<24> 


DATA 5 (To Printer) 


7<25> 


DATA 6 (To Printer) 


8<26> 


DATA 7 (To Printer) 


9<27> 


DATA 8 (To Printer) 


1<19> 


STROBE (To Printer) 


<n> ground 
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B^ CASSETTE INTERFACE DATA (DB32016) 
Cassette Interface Cable 

The cassette interface cable can be constructed from readily available components. It is 
connected to the auxiliary out or earphone jack of a cassette recorder and the system parallel 
port. Additionally, interface circuitry is required at the connector to the parallel port. The 
diagram illustrates the hardware requirements at both ends of the interface cable. The 
components required for the parallel port interfacing are presented in the parts listing. 



+5v 



DATA BIT IN 
(BIT 0) 



DB32016 




4.7k 



JI-48 



DATA BIT OUT 
(BIT 0) 



NOTE ON DB16000 Jl 1-49 
ARE GND 




Jl-16 



SPECIAL SIMPLE CASSETTE INTERFACE 
CONNECTED TO Jl 

FROM RECORDER 
EARPHONE OR 
2N2222 Ik AUX OUT 




Ik 



iMf 



ZZ GND 



H: GND 



2.2k 



SHIELDED CABLE 
<| TO RECORDER INPUT 




221 



ZZ. GND IZ 



FC-03-0 
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PARTS LIST 


QTY 


DKSC 


1 


2N2222 Transistor 


2 


IK Resistor 


1 


2.2K Resistor 


1 


22 ohm Resistor* 


1 


.1 microfarad Capacitor 


2 


Audio Connector Plugs 


1 


100-pin connector 



*This value may be dependent on the particular recorder used. 

INTERFACE TIMING DATA 

Timing data is provided to aid the user in calculating the value of @n as it is lised in the TW 
(tape write) command, for board frequencies other than 14 MHz. 

The timings generated by the program produce a serial data flow rate of approximately 330 
baud. The efiTective recording frequency is approximately 660 Hz. The diagram illustrates the 
timings of pulse waveforms. 

CLOCK PERIOD DATA PERIOD 



T 

Vhi 

± 



//- 



HI=1 
L0=0 



Tp 



k 



Tp 



Tw 



"// 



Tw 



BAUD RATE =- 



1 



2xTw 



FC-02-0 



OUTPUT PULSE TIlV-nNG: (At UX7 pin 11) 

Tp = .500 ms ± 10% 
Tw = 1.5 ms ± 10% 
Vhi = TTL level Voh 

Input to the recorder at the voltage divider should be 20-100 mV depending on the recorder 
used. The user may connect an oscilloscope probe to pin 11 of UX7 and then use the TW 
command to enter trial values for n until the output pulse timing shown in the diagram is 
observed. 
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INPUT PULSE TIMING: (At U4 pin 8) 

Tp = .280 ms minimum 
Tw = 1.5 ms ± 10% 
Vhi = TTL level Voh 

This waveform can also be observed at the tape header or by recording binary data with all 
bytes set to -1, and then by reading the data back. 



B.6 ASSEMBLER USER NOTES (DB32016) 

The assembler was written to be as consistent as possible with available assembler 
documentation, but due to its compactness, certain exceptions must be observed. Those 
exceptions are listed below: 

1 . ASCII strings are delimited by double quotes only. 

2. Symbols are valid for PC address and SB segment mode only. 

3. Symbols must contain only two characters. 

4. The only operation allowed is subtraction between symbols. 

5. Strings are valid only for .BYTE Pseudo-op and immediate operands. 

6. RO through R7 are the only recognized register mnemonics. All others must be hex 
encoded. 

7. CXP argument is simply n. 

8. CBITIi and SBITIi instructions are not implemented. 

9. Registers RO through R7 must be used for FO through F7. 

10. Immediate floating-point values not allowed. 

11. The STATIC area must be declared as the first element of the program. 

12. Pseudo-ops parse on first four characters only. 

13. All lower case characters in the string of .BYTE will be changed to upper case 
during assembly. 

14. LXPD instruction not implemented. Use ADDR EXT(n), DESTINATION. 

The assembler does not fully support operand legality checking, value range checking, and 
some soft parsing. Immediate operand values are truncated and no error message is issued. 

Certain parsing errors such as balanced parentheses are not checked. Characters other than 
those, allowed by syniax rules are not checked for and may not output an error message. 
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B.7 TDS MEMORY MAP (DB32016) 

The diagram is a graphic representation of the memory space available to TDSs. 

ADDR 



PROM 

RANGE 



ITTPFF 





IDS 




Code 


<-H'5000 


lUS Module table 


<-H'5100 


i'US Interrupt and Trap table 


<-H'5200 


rUL Link table 



H'SOOO 



RAM 
RANGE 



In auto mode 
user module 
table is 





i'US variables 


<-H'8200 






IDS stack 


<-H'8500 




<-H'8600 


User IS 


<-H'8700 


IDS variables 





// // 




<— X = ITSOO + # of characters in source 




+ 9*(# of lines in source) 


-> 


<— @ first available 1/2 page boundary * 


-> 


<— @ first available page boundary 


-> 


<— @ first available page after code 


-> 


<— @ Highest mem addr - 11 (rxp pushed onto stack) 



User Code is — 

User Static base 

User SP 

*Unless memory available is greater than or equal to 64K, the module table is constructed 
within the reserved system area. 
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B.8 TDS ERROR SUMMARY (DB32016) 

TDS system error messages are summarized as follows: 



BAD_TXT 
ERR^D# 
BAD_MEM 

BAD_SEO 

BADJNS 

BADJ>SU 

ERRJVAL 

BAD_LIN 

ERR_SEG 

BADJSfUM 

BAD^YM 

UND_SYM 

BADJTAB 

ENMI 

ENVI 

EFPU 

EDVZ 

EUND 

EFLG 

EBPT 

EILL 

EEXT 

EBPR 

ENST 

E ABT 

ESRC 

ESVC 

ECXP 



Bad text input. 

Error in edit number. 

Code start addr conflicts with text or debug data. Enter a higher 
value for addr. 

Attempting to assemble null or bad text. 

No such instruction. 

No such Psuedo-op. 

Bad number syntax or bad operand. 

Gross line error or standalone label. 

Using data allocation Psuedo-ops within PC segment or vice versa. 

Bad floating-point syntax or value range. 

Duplicate symbol. 

Undefined symbol. 

Assembler was not initiated by IT command. 

Error - Non-maskable interrupt. 

Error - Non-vectored interrupt (not implemented). 

Error - FPU trap. 

Error - divide by zero. 

Error - undefined op-code (trying to use non-existing MMU or 
FPU). 

Error - flag trap. 

Error - non-debugger BPT instruction. 

Error - illegal for user instruction. 

Error - external abort. 

Error - MMU breakpoint. 

Error - MMU non-sequential trace trap. 

Error - MMU address translation. 

Error - memory search failed. 

Error - unknown SVC. 

Error - more than one call command. 
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EVRF 
TI]V!_PUT 

BADJ^RM 
CRC ERR 



Memory verify error (breakpoint could not be inserted). 

No data pulses present. This message occurs approximately 90 
^conds after a data operation is initiated if no data pulses are 
detected. 

Bad tape format. Attempted to read data that does not conform to 
the established data format. 

A CRC error was detected. 



B.9 TDS COMMAND SUMMARY (DB32016) 

The commands used in the TDS system are summarized as follows: 



RX |H|D} 
OM gn 

IN [n ] string 






RP n string 

K n 

RS 

RL [lPT:|ASN:] [c] 



AS [a<f<fr] 

B {Z\mod offset] 



PM {B|W|D|F|l} {addr\symbol} 



PAD symbol 



Select the system base to be hexadecimal or 
decimal. 

Set the terminal communications mode. See 
Section 3.3.2. 

Insert string above or after line n of the text 
buffer. 

Ttrne line n.! of text buffer or f^^e n2 lines 
of buffer beginning with nl. 

Replace line n of buffer with string. 

Kill or delete line n from text buffer. 

Reset clear text buffer. 

Redirect listing from terminal to printer at 
parallel port or serial device at port 1, and 
end listing with a <CR> or cancel 
previously selected device. 

Begin the assembly of user program at 
address addr. 

Initialize a user program if an explicit 
address was used as assembly time. If an 
explicit address was not used, mod and offset 
may be omitted. The Z option zeros memory 
from the SB to the SP area. 

Print memory contents according to selected 
base. Byte, Word, Double-word, Floating- 
point or Long. 

Print address of symbol. 
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PR {0|1|2|3|4|5|6|7} 

Pcpureg 

PMS 

PPT {()|l} 

PEl 

PPF {0|l} 

PSC 

PBP {0|._|[l5|f]} 

PBC 

PF {0|li2|3l4|5|6|7} 

PFS 
PCF 

PMM 
AR 

AC 

AM 

AF 

CM {B|W|D} {addr\symbol=gn} 

CM {F|L} {addr\sy7nbd--rn} 

Ccpureg = gn 
CMS = gn 

CPT {0|l}=gn 

CEl = gn 



Print the contents of one of eight general 
purpose registers. 

Print the contents of the CPU register. 

Print the contents of the MMU MSR register. 

Print the contents of the MMU PTB register. 

Print the contents of the MMU 
EADDR/INVAL register. 

Print the contents of the MMU PF register. 

Print the contents of the MMU SC register. 

Print the contents of one of 16 breakpoint 
registers. 

Print the contents of one of the MMU BCNT 
registers. 

Print the contents of one of eight FPU 
registers. 

Print the contents of the FPU status register. 

Print configuration. 

Print the contents of the main MSF register. 

Print the contents of all general purpose 
registers. 

Print the contents of all CPU registers. 

Print the contents of all MMU registers. 

Print the contents of all FPU registers. 

Change memory contents, at specified 
location, to an integer value. 

Change memory contents at addr or symbol 
to a real number. 

Change contents of the CPU register to gn. 

Change the contents of the MSR register to 
gn. 

Change the contents of the PTB register to 
gn. 

Change the contents of the EADR/INVAL 
register to gn. 
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CSC = gn 

CBP {0|_.![l5!f]} = {addr symbol] 

CBC = gn 

CF {0|l|2|3|4|5|7}=gn 

CFS = gn 

CCF = gn 

CMM = gn 

ST[n] 

SIT laddrl onrealcDurp.O) onJ otl7 crnTnu^k 



SW I addr \ gpreg | cpureg \ gnl gn2 gnmask 



JS addr 

CX mod offset 

GO 



]\4 nrinrl n/idr^ o^ 



¥ addrladdrlgn [B|W|D] 



Change the contents of the MMU SC 
register. 

Change the current addr or symbol of one of 
sixteen breakpoint registers to addr or 
symboL 

Change the memory contents of the MMU 
NCNT register to gn. 

Change the memory contents of one of eight 
FPU registers to gn. 

Change the memory contents of the 
floating-point status register to gn. 

Change the memory contents of the 
configuration register to gn. 

Change the memory contents of the main 
MSR register to gn. 

Step through the user program for n 
instructions and then break. Default for n is 
one. 

Step throuc^h a user nro«rram until the 
contents of memory at addr, or gpreg (RO- 
R?), or cpureg masked with gnmask, is 
greater than or equal to gnJ and less than or 
equal to gn2. 

Step through a user program while the 
memory contents of either addr, or gpreg, or 
cpureg masked with gnmxisk, are greater 
than or equal to gnl and less than or equal 
to gnl. 

Call a subroutine at location addr. 

Call external subroutine at address 
calculated using mod and offset from the 
module table. 

Begin program execution. 

Move gn sequential bytes of data from 
memory location addrl to addrl. 

Fill memorj' locations from addrl to addrl 
with data gn. 
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SR addrl addrl gn [b | W | D ] 



D addrl gn 



TW [@n ] [addrl addrl ] 



TR [addr] 



Search memory between addrl and addrl 
for data gn and print its address according to 
BWD. 

Dump gn locations beginning at addrl, to 
the user terminal. 

Write data between location addrl and 
addrl to the cassette recorder. Otherwise, 
write contents of editor text buifer to the 
cassette recorder. @n specifies timings for 
boards not equipped with a 14 MHz crystal. 
See Chapter 9.2 for details. 

Read data from the cassette tape and store it 
in memory beginning at location addr. 
Otherwise, load the data into the editor text 
buffer. 



B-12 



Appendix C 
TDS ON THE DB32000 

C.1 AUXILIARY PORT SETUP PROCEDURES (DB32000) 

The auxiliary port (J2) of the DB320(X) is an integral part of the board. It requires no setup 
unless user wishes to deviate from shipping configuration. Port is fully baud programmable as 
determined by dip switch setting (^e Section C.2). 

C.2 BAUD RATE SETUPS (DB32000) 

The following dip switch settings on the DB32000 control the baud rates of port and port 1. 
S4 S3 S2 SI Baud Rate 



on 


on 


on 


on 


19200 


on 


on 


on 


off 


9600 


on 


on 


off 


on 


7200 


on 


on 


off 


off 


4800 


on 


off 


on 


on 


3600 


on 


off 


on 


off 


2400 


on 


off 


off 


on 


2000 


on 


off 


off 


off 


1800 


off 


on 


on 


on 


1200 


off 


on 


on 


off 


600 


off 


on 


off 


on 


300 


off 


on 


off 


off 


150 


off 


off 


on 


on 


134 


off 


off 


on 


off 


110 


off 


off 


off 


on 


75 


off 


off 


off 


off 


50 



Switches 5, 6, 7, 8, 9 and 10 unused. 

NOTES: 1. Required terminal characteristics: 

a. Parity - disabled 

b. Stop bits = 1 

c. Character length = 8 bits 

2. At reset, both ports programmed to switch setting. 

3. Port 1 (auxiliary) may be independently programmed using @R 
command (see Section 9.5.3). 

4. To calculate @R value 0N=1, OFF=0. 
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C.3 NUMERICAL DATA (DB32000) 

Integer Ranges and Data: 

Decimal -2147483648„21474836647 

Hex 0_.FFFFFFFF 

• No equivalence checking. 

• No overflow checking in ASCII to binary conversion. 

• Syntax checked in ASCII to binary conversion. 

• Hex output interpreted as unsigned. 

• Decimal treated as signed for binary to ASCII conversion. 

• Decimal treated as signed or unsigned depending on the value in an ASQI to binary 
conversion. 

• Numbers too large for operand size are truncated in the high bits. 

Floating-Point Ranges: 

Long max =16 digits ± 307 exponent range 
Short max = 8 digits ± 37 exponent range 

Floating-Point Accuracy: (Conversion with no arithmetic operation) 

Long format: 16 digits ± 2 LSD 
14 digits ± .5 LSD 

Short format: 8 digits ± 2 LSD 
6 digits ± .5 LSD 

Floating-Point Errors: 

Syntax and range checking for ASCII to binary conversions. 

No NaN recognition for binary to ASCII conversion. 



C.4 PARALLEL PRINTER INTERFACE DATA (DB32000) 

The parallel printer port supports a Centronics or an equivalently strobed printer. This 
information is provided for the user who wishes to construct a printer interface cable. In this 
case, a high quality twisted-pair cable is mandatory. However, it is advisable to use the SPX 
Centronics printer interface cable (part number 601 304044-001). 

Shown below are the signal pin-outs for the printer interface cable. 
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DB32000 


100-PIN EDGE 


36-PIN D 


PRINTER 


PARALLEL PORT 


CONNECTOR 


CX)NNECTOR 


SIGNAL NAMES 


47 


A24 


11<29> 


BUSY (From Printer) 


37 


A19 


13 


SELECTED (From Printer) 


23 


A12 


2<20> 


DATA 1 (To Printer) 


21 


All 


3<21> 


DATA 2 (To Printer) 


19 


AlO 


4<22> 


DATA 3 (To Printer) 


17 


A09 


5<23> 


DATA 4 (To Printer) 


25 


A13 


6<24> 


DATA 5 (To Printer) 


27 


A14 


7<25> 


DATA 6 (To Printer) 


29 


A15 


8<26> 


DATA 7 (To Printer) 


31 


A16 


9<27> 


DATA 8 (To Printer) 


15 


A08 


1<19> 


STROBE (To Printer) 




Bn ground 


<n> ground 





The software driver logic is compatible with XU155 as a 74640 and XU138, XU149, and 
XU132 as 7437. Ensure that XU155 is selected in receive mode (berg connector acrc^s 1-2 at 
W60). 



C^ CASSETTE INTERFACE DATA (DB32000) 

Cassette Interface Cable 

The cassette interface cable can be constructed from readily available components. It is 
connected to the auxiliary out or earphone jack of a cassette recorder and the system parallel 
port. Additionally, interface circuitry is required at the connector to the parallel port. The 
diapram illustrates the hardware reauirements at both ends of the interface cable. The 
components required for the parallel port interfacing are presented in the parts listing. 
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+5v 



DATA BIT IN 
(BIT 0) 




DB32QQQ 



DATA BIT OUT 
(BIT 0) 



NOTE ON DB3200Q Jl 2-50 
ARE GND 



4.7k 



J3-47 




11 



J3-15 



SPECIAL SIMPLE CASSETTE INTERFACE 
CONNECTED TO J3 




2N2222 



Ik 



Ik 



FROM RECORDER 

EARPHONE OR 

AUX OUT 

— < 



iMf 



X 



GND IZ 



GND 



2.2k 



22^ 



GND 



PARTS LIST 



SHIELDED CABLE 
TO RECORDER INPUT 



FC-04-0 



QTY 



DESC 



1 


2N2222 Transistor 


2 


IK Resistor 


1 


2.2K Resistor 


1 


22 ohm Resistor* 


1 


.1 microfarad Capacitor 


2 


Audio Connector Plugs 


1 


100-pin connector 



*This value may be dependent on the particular recorder used. 
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INTERFACE TIMING DATA 



Timing data is provided to aid the user in calculating the value of @n as it is used in the TW 
(tape write) command, for board frequencies other than 14 MHz. 

The timings generated by the program produce a serial data iiow rate of approximately 330 
baud. The effective recording frequency is approximately 660 Hz. The diagram illustrates the 
timings of pulse waveforms. 



CLOCK PERIOD 



DATA PERIOD 



± 



//- 



Tp 



Tw 



HI=1 
L0=0 

Tp 



-// 



Tw 



BAUD RATE »- 



2xTw 



FC-02-0 



OUTPUT PULSE TIMING: (At UX7 pin 11) 

Tp = .500 ms ± 10% 
Tw = 1.5 ms ± 10% 
Vhi = TTL level Voh 

Input to the recorder at the voltage divider should be 20-100 mV depending on the recorder 
used. The user may connect an oscilloscope probe to pin 11 of UX7 and then use the TW 
command to enter trial values for n until the output pulse timing shown in the diagram is 
observed. 

INPUT PULSE TIMING: (At U4 pin 8) 

Tp = .280 ms minimum 
Tw = 1.5 ms ± 10% 
Vhi = TTL level Voh 

This waveform can also be observed at the tape header or by recording binary data with all 
bytes set to -1, and then by reading the data back. 
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C.6 ASSEMBLER USER NOTES (DB32000) 

The assembler was written to be as consistent as possible with available assembler 
documentation, but due to its compactness, certain exceptions must be observed. Those 
exceptions are listed below: 

1. ASCII strings are delimited by double quotes only. 

2. Symbols are valid for PC address and SB segment mode only. 

3. Symbols must contain only two characters. 

4. The only operation allowed is subtraction between symbols. 

5. Strings are valid only for .BYTE Psuedo-op and immediate operands. 

6. RO through R7 are the only recognized register mnemonics. All others must be hex 
encoded. 

7. CXP argument is simply n. 

8. CBITIi and SBITIi instructions are not implemented. 

9. Registers RO through R7 must be used for FO through F7. 

10. Immediate floating-point values not allowed. 

11. The STATIC area must be declared as the first element of the program. 

12. Pseudo-ops parse on first four characters only. 

13. All lower case characters in the string of .BYTE will be changed to upper case 
during assembly. 

14. LXPD instruction not implemented. Use ADDR EXT(n), DESTINATION. 

The assembler does not fully support operand legality-checking, value range checking, and 
some soft parsing. Immediate operand values are truncated and no error message is issued. 

Certain parsing errors such as balanced parentheses are not checked. Characters other than 
those allowed by syntax rules arc not checked for and may not output an error message. 



C.7 TDS MEMORY MAP (DB32000) 

The diagram is a graphic representation of the memory space available to TDSs. 
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RAM 
RANGE 



In auto mode 
user module 
table is 



User Code is 
User Static base 
User SP 





mem < W12Q0 not used 


<-H'7200 


JDS Module table 


<-H'SOOO 






TDS variables 


<-H'8200 






TDS stack 


<-H'8500 




<-H'8600 


User IS 


<-H'8700 


TDS variables 





// // 




<— X = H'600 + # of characters in source 




+ 9*(# of lines in source) 


> 


<- @ first available 1/2 page boundary * 


> 


<— @ first available page boundary 


> 


<— @ first available page after code 


> 


<— @ Highest mem addr - 11 (rxp pushed onto stack) 



ADDR H'AOOOOO 





lUS 




Code 


<-H'AO720O 


Module table (is written to RAM at reset) 


<-H'A07400 


Interrupt and Trap table 


<-H'A07600 


Link table 



PROM 
RANGE 



H'A07FFF 

*Unless memory available is greater than or equal to 64K, the module table is constructed 
within the reserved system area. 



C.8 TDS ERROR SUMMARY (DB32000) 

TDS system error messages are summarized as follows: 
BADJTXT Bad text input. 

ERR_ED# Error in edit number. 

BAD MEM 



BAD_SEQ 



Code start addr conflicts with text or debug data. Enter a higher 
value for addr. 

Attempting to assemble null or bad text. 
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BAD_INS 

BAD_PSU 

ERR_VAL 

BAD_LIN 

ERR_SEG 

BAD_NU1V1 

BAD_SY]VI 

UND_SYM 

BAD_TAB 

ENMl 

ENVI 

EFPU 

EDVZ 

ELTND 

EFLG 

EBPT 

EILL 

EEXT 

EBPR 

ENST 

EABT 

ESRC 

ESVC 

ECXP 

EVRF 

TIMjOUT 

BAD_FRM 
CRC ERR 



No such instruction. 

No such Psuedo-op. 

Bad number syntax or bad operand. 

Gross line error or standalone label. 

Using data allocation Psuedo-ops within PC segment or vice versa. 

Bad floating-point syntax or value range. 

Duplicate symbol. 

Undefined symbol. 

Assembler was not initiated by IT command. 

Error - Non-maskable interrupt. 

Error - Non-vectored interrupt (not implemented). 

Error - FPU trap. 

Error - divide by zero. 

Error - undefined op-code (trying to use non-existing MMU or 
FPU). 

Error - flag trap. 

Error - non-debugger BPT instruction. 

Error - illegal for user instruction. 

Error - external abort. 

Error - MMU breakpoint. 

Error - MMU non-sequential trace trap. 

Error - MMU address translation. 

Error - memory search failed. 

Error - unknown SVC. 

Error - more than one call command. 

Memory verify error (breakpoint could not be inserted). 

No data pulses present. This message occurs approximately 90 
seconds after a data operation is initiated if no data pulses are 
detected. 

Bad tape format. Attempted to read data that does not conform to 
the established data format. 

A CRC error was detected. 
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C.9 TDS COMMAND SUMMARY (DB32000) 

The commands used in the TDS system are summarized as follows: 

RX [H|D] 



OMgn 

IN [n]string 

TP [ni[/n2]] 

RP n string 

K n 

RS 

RL [LPT:|ASN:][c] 

AS [afi?<fr] 

B { [z]|mod offset} 



PM{B|W|DiF|L} {addr\symbol} 

PAD symbol 

PR {0|1|2|3|4|5|6|7} 

Pc/>wreg 

rivib 

PPT {0|l} 

PEl 

PPF {0|l} 



Select the system base to be hexadecimal or 
decimal. 

Set the terminal communications mode. See 
Section 3.3.2. 

Insert string above or after line n of the text 
buffer. 

Type line nl of text buffer or type n2 lines 
of buffer beginning with nl. 

Replace line n of buffer with string. 

Kill or delete line n from text buffer. 

Reset clear text buffer. 

Redirect listing from terminal to printer at 
parallel port or serial device at port 1, and 
end Listing with a [CR J or cancel previously 
selected device- 
Begin the assembly of user program at 
address addr. 

Initialize a user program if an explicit 
address was used as assembly time. If an 
explicit address was not used, mod and offset 
may be omitted- The Z option zeros memory 
from the SB to the SP area- 
Print memory contents according to selected 
base. Byte, Word, Double-word, Floating- 
point or Long- 
Print address of symboL 

Print the contents of one of eight general 
purpose registers. 

Prmt the contents of the CPU register. 

Print the contents of the MMU MSR register. 

Print the contents of the MMU PTB register. 

Print the contents of the MMU 
EADDR/INVAL register. 

Print the contents of the MMU PF register. 
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PSC 

PBP {0|_.|[l5|f]} 

PBC 

PF {0|1|2|3|4|5|6|7} 

PFS 
PCF 
PMM 
AR 

AC 

AM 

AF 

CM {B|W|D} {addrlsymbol^^gn} 

CM {F|L} {addr\symbd=rn} 

Ccpureg = gn 
CMS = gn 

CPT {0|l}=g;i 

CEI = gn 



CSC = gn 



CBP {0|-.|l5|f}= {addr\symbd} 



CBC = gn 



CF {0|l|2|3|4|5|7}=g;z 



Print the contents of the MMU SC register. 

Print the contents of one of 16 breakpoint 
registers. 

Print the contents of one of the MMU BCNT 
registers. 

Print the contents of one of eight FPU 
registers. 

Print the contents of the FPU status register. 

Print configuration. 

Print the contents of the main MSF register. 

Print the contents of all general purpose 
registers. 

Print the contents of all CPU registers. 

Print the contents of all MMU registers. 

Print the contents of all FPU registers. 

Change memory contents, at specified 
location, to an integer value. 

Change memory contents at addr or symbol 
to a real number. 

Change contents of the CPU register to gn. 

Change the contents of the MSR register to 
gn. 

Change the contents of the PTB register to 

Change the contents of the EADR/ INVAL 
register to gn. 

Change the contents of the MMU SC 
register. 

Change the current addr or symbol of one of 
sixteen breakpoint registers to addr or 
symbol 

Change the memory contents of the MMU 
NCNT register to gn. 

Change the memory contents of one of eight 
FPU registers to gn. 
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CFS = gn 
CCF = gn 
CMM = gn 
ST[n] 

SU { addr \ gpreg \ cpureg \ gnl gn2 gnmask } 



S W I addr j gpreg j cpureg } { gnl gnl gnmask } 



Change the memory contents of the 
floating-point status register to gn. 

Change the memory contents of the 
configuration register to gn. 

Change the memory contents of the main 
MSR register to gn. 

Step through the user program for n 
instructions and then break. Default for n is 
one. 

Step through a user program until the 
contents of memory at addr, or gpreg (RO- 
R7), or cpureg masked with gnmask, is 
greater than or equal to gnl and less than or 
equal to gn2. 

Step through a user program while the 
memory contents of either addr, or gpreg, or 
cpureg masked with gnmask, are greater 
than or equal to gnl and less than or equal 
to gn2. 



CX mod offset 

GO 

M addrl addrl 



Yaddrl addrlgn [b|W|d] 
SR addrl addrl gn [B | W | D ] 



D addrl 



g^ 



iw [(^j ^addrl addrl j 



Call external subroutine at address 
calculated using mod and offset from the 
module table. 

Begin program execution. 

Move gn sequential bytes of data from 
memory location addrl to addrl. 

Fill memory locations from addrl to addrl 
with data gn. 

Search memory between addrl and addrl 
for data gn and print its address according to 
BWD. 

Dump gn locations beginning at addrl, to 
the user terminal. 

Write data between location addrl and 
addrl to the cassette recorder. Otherwise, 
write contents of editor text buffer to the 
cassette recorder. @n specifies timings for 
boards not equipped with a 14 MHz crystal. 
See Chapter 9.2 for details. 
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TR [arfrfr] Read data from the cassette tape and store it 

in memory beginning at location addr. 
Otherwise, load the data into the editor text 
buffer. 
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